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ACE SERVICES TO 
BUSINESS 



ACE 

COMPUTERS 



iters are able tot 
ier te whole range of computer reedt. Oi, r j^ice; 
include analysirg 

compute solutions; supplying computer systems including 
a I eqjipment ann prog*ammes; inaiallation of equipment 
aid training, 

We ofler a rang* of financing facilities - mitten 
■ ctetalb on request 
I guarantee nert day service throughout the country, 

Whether you are computerising l» the first time, or 
idaling existing systems, ACE will be most pleased lo 
lerlromyou! 

Gsl c-jr Cj$turra Liaison Desk at the nearest 



FOR MAIL ORDER 

P CALL n ^'l SPECIAL MESSAGE 
1"L B «2 8,Z TO RETAILERS 



~E are ate to sjpply EPOS ard computerised stock 
mtrol systems lo suit from one lo eirjhl shops. These 

■'::■.■■. ■ ; ' ' . ' : 

■q:..ui: ih-j losle C'Fli'ancingstock. 

Our comprehensive service includes programme 
edification to meet your needs; supply and installation of 
percent and training, 

F nancing facilities ate available - written details on 
iquest - and our maintenance contracts guarantee next 

Prices will surprise you! Call oumearest stop or our 
risiol nutnter and ask for ihe L ■ 



1 ill 


FRANCHISE 
SERVICES 


SWINDON. 
0793 512073 

Robtrtstn Site 
HASTINGS. 
0424 42292 

a Parliament S 


reel 


Ac; C':."T..i»r:; nave a 'iiui'y sjccessful franchise 
opsation. If you are interested in opening your own 
comufer stop, please call us and ask for a copy of Die 
Franchise Brochure. 

WE HAVE A NUMBER OF SHOPS READY TO START IN 

BRISTOLAND NOTTINGHAM 


.0602 47387 
5 Samhoun flu 




PHILIPS MONITORS 



ALL PRICES 



INCLUDE FREE 
NEXT DAY 
DELIVERY 
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32 SPRITES 

The world of sprites opened up 
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42 Gel it right when you do your programming 

MULTITASKING C128 

This absorbing topic is Rearing the end 




SUPER 
SNAPSHOT v5 

Well, it may havetakena fen years of hard workand 
fire powerful versions, path one breaking new 
ground, but Super Snapshot lias bet one the best 
cartr dec: ■: the norlrt. The list below details the 
main features ol Super Snapshot v5; if you need a 
littlenore persuasion look batkto CDU issue 19. 
you'll he impressed. 

So take a look at the red oo< you've got plugged 
in, and Hour specifications knock it foi si* or 10. 
don'lo»nacartridgethendon'tjus:si!:herr hii;, 
Super Snapshot v5 today! 

FEATURES: 

*■ All features available at the press ol a buttw 
>v Works with all ik (c) and 128 (D] compel- •< 
p> Conpatible with I700 ; II6'>.''1750 REU S 
►■Snapany memory resident progranintjii'; 
»• Sate 7 ■■ faster and load 15 •: faster on the V 
1571 a 1581. SpeedsofuptoJSi faste- lo- 
using Turbo 25 -even faster than Repn. 
n> Super DOS Wedge 

► CAME MASTER menu with sprite killer 
iniinit ; vei ;, <es generator and joystick?:'! 
swapper 

►> Programmable function Keys 

p- Sprite Monitor 

¥■ Exclusive Character Set Monitor 

► Exclusive Sound Sample Monitor 

► Exclusive Boot sector support 

P> 3 00.' 1 1 DO. 1 '2 WO Terminal program 

(WW) column) 
*■ SUPER DISK SNAPSHOT- our new supe- 

nibble r 
p> SCREEN-COPY now loads or saves in more 

lormalsanddumpsinCOLOURtoSTJRLUOC 

printers and in 16 grey scales 

► Improved lull featured M.L monitor that DOES 
NOT CORRUPT MEMORY. Interrupt, examine 
and resume any running program 

t> BASIC PLUS with 15 new BASIC commands 

► FILE MANAGEMENT SYSTEM - scratch, 
unscratch, rename or adjust skew. Include; 
our I or 2 drive file copier with partition 
support for the ISBI 

► Fast disk copier, 1 or 2 drives 

p- OUR FILE COPIER. DISK COPIERS and 
NIBBLER MAKE FILL USE OF THE RED'S 

► Sequential file reader 

► Utility disk 

► Plus 150- KrackerJa* parameters 

ONLY £34.95 



"■J" F^V Prices include VAT 4 U.K. 
hh '^ ™ delivery. Overseas orders 
nd advertised priie plus £3.50 for Airmail. 

jstal Order or Credit Card 
ta s v ^ ACCFSSorders accepted hy 'phone. 
Aasons Ryde, 
>efford Road, 
ershore. Worcs. 
VR10 1 AZ. 
fel: (0386) 553153 

lical Support 
el: (0386) 553222 




ANIMATION 
STATION 

Unleash your creativity with Animation Station, a 
Mwerfui utility for generating all kinds of 
KOhncn your Commodore 64 or 1 28. Built-in, 
f-ecaw pictures give you a head start on your 
:-m: ms Automatic generation ol circles, ovals, 
squares boxes, straight lines, typography and 
- . : i i ■: ;h;if..i^.-i;,-.u lill :he tools of a 
■ --;d eleciranic Jriinis'i-.-jr 1 

:■:*;■: craphics on the screen, draw - -;-■ 
;c lurs even connect your VCR to create I ties 

rsiiir vc'j-rii;"'t r'ovies. Sc ■ 

10 jour prinUr, Koala Compatible. Pack:gs 
i, .:■■ design tcucr p,i.:. jc-nc and; 
software Ideal for CEOS users. 

ONLY £59.95 



VIDEO BYTE 3 

DigftiMi dec images from your VCR, Iswc* 
firt --;w camera. nfftheairorcable"v New 
.e:s if ; ) software features full re-di.: ■., * " 
r. ikipiura mode, menu select printing 
;' f _,.u,. co.ouriiing features, save to; •• •■■••. 
much more. The hardware is no larger t-;*;r 

■::■■ ti ::;■ ;j ".ridge wnith plugs into the Lse' P;rt 

The menu driven capture software is easy ic .se 
and pictures stored to disk can be impc"-: r.ic 
most popular drawing packages inciudi-t .:.: 
Pri'-.s n Ml colour to the Star LC10 when usee 

with Super Snaps hot. 

ONLY £79.95 



HOME VIDEO 
PRODUCER 64 

Nothing can make home videos so spec a 1c; 
titles, text, and even brilliant graphics:: .jur 
f:-tC"j'':e home videos with ease and the "- J :' 
the Home Video Producer. You have there :ec' 
10 typefaces. 75 large full-colour graph ii ri 
ready made segments, but the most ap;ea -g 
aspect of the Home Video Producer Is t:e esse 

ONLY £29.95 



C64 SLIMLINE 
UPGRADE CASE 

Make your older C64 look like a newer model! j 
you need is a screwdriver and about 15 minutes I 

your C64 insides to this new case. 
Complete Instructions included. 

ONLY £12.95 




CARTRIDGE 
PORT EXTENDER 
CABLE 

Are you crampedfor space behind your computer? 
Is itnard to reach your cartridge port to plug-in or 
sttapcartridgeslThishandy cable isthe solution. 
The Cartridge Port Extender Cable connects to 
the tartr ip port in the backof the computer and 
.... .... .i.,g in your cartridge to Its other end. 

■ ■■ able is fleiible, you can locate the 
tatr:dgeuptoll"awayfor easier access. Not for 
REUi 

ONLY £19.95 



GEOS 
APPLICATIONS 

GEOSCAN ART 

>is'jf:.al type of CEOS art has been created 
.< ; ' ie -andyScanner M. Pkturesare scanned 
at -0C )p from magazines, books and papers to 
teate :■: lirst geoSCAN ART Collection entitled 
>c Br.r ;• Countryside and is packed full with 
Ea| : : . --Is and Butterflies. 

ONLY £6.95 

GEO DIRECTORY 

■■", h ■::■"■ I I i.' . ■ ■! |i:> 

. :■ ■•■ Details for each program is given 
mc .mf.irsiM numbers. ThegeoDirectory is 
:■ J aitr.. Write, Spell. 
file (;: ^hart, Terminal. Graphic. Music. 

Canes and many more. 

ONLY £ 6-95 

GEOTRONIX 

1 p c'e'vional PCB designer utilizing the CEOS 
e-.imr?ent. Five double sided disks supply 
geoF.fc' ,h with pre-designed components, 
streets edge connectors and layout grids in 
; ---- ir-.ps. Using the Photo Manager and 
^.'iPut s- the circuit is designed and printed. 

ONLY £39.95 



GEOS 64 V2.0 


£29 


GEOCALC 64 


£24 


GEOFILE 64 


£24 


GEOPROGRAM/V 


ER £29 


DeskPack Plus 


£19 


GEOCHART 


£19 


GEOS 123 V2.0 


£39 


GEOCALC 128 


£29 


GEOFILE 128 


£29 


GEOPUBLISH 


£29 


FontPack Plus 


£19 


Int. Font Pack 


£19 



INSTRUCTIONS 



MERRY CHRISTMAS and HAPPY NEW YEAR 



It doesn't seem possible does it? Why, only a few CDU 
months ago, or so it seems, I was wishing all of you them 
MERRY CHRISTMAS and HAPPY NEW YEAR. So 



you do not pass 
them for profit, 
copies, we have 

again, I echo those words of last year. I sincerely hope provided a very simple machine code file copier. To use 
thai each and everyone of you has the kind of festive it, simply select the item FILE COPIER from the main 



n that they are hoping for. 

This last twelve months has seen .? lot of changes in 

this world, and even more at the CDU offices. A lot of 

them you are all aware of (but there are just as many 

that you aren't!. One of those changes you will notice 



■> lhi~ n 






nths disk. FOR THIS ISSUE ONLY, you will work o 






have to load the menu with the command LOAO"CDU 

MENU'%8,1 and not the normal LOAD"MENU",8,h experience prob 1 1 

This is because of the way one of the programs has been 

programmed on the disk. 

On the disk is a program called TERMINUS. This 
program is in fact one of those DEMOs that I am 
constantly being asked to publish. HOWEVER, this one 
is decidedly different to all the normal demos you see. 
Enjoy!! 

I will Finish now by saying once again, a very big 
thank you for your past interest and support of the 
magazine. Have a really great Christmas. Sec you all in 
the new year. Paul Eves (El GroupoU). 

DISK INSTRUCTIONS 

Although we do everything possible to ensure that 
CDU is compatible with all C64 and CI 28 computer: 



!.■ | irrMTiiri! i m -i ree 

DISK FAILURE 



the disk with your copy of CDU will not 
then please carefully re-read the 



peraling instructions in the magazine. 



e poin' 



uke l. 



s this. The 



l 'Fast 



Loaders', 'Cartridges' or alternative operating systems 

such as 'Dolphin DOS', may not guarantee lh.it your disk- 
will function properly. If you experience problems and 
you have one of the above, then we suggest you disable 
them and use the computer under normal, standard 
conditions. Getting the programs up and running should 
not present you with any difficulties, simply put your disk 
in the drive and enter the command. 

LOAD-CDU MENU",8,1 

Once the disk menu has loaded you will be able to start 
any of the programs simply be selecting the desired one 
from the list. It is possible lor some programs to alter the 
computers memory so that you will not be able to LOAD 
programs from the menu correctly until you reset the 
machine. We therefore suggest that you turn your 
computer off and then on again, before loading each 
program. 

HOW TO COPY CDU FILES 




After eight weeks a replacement disk can he supplied 
from INTERCEPTOR CROUP for a service charge of 
£1.00. Return the faulty disk with a cheque or postal 
order made out to INTERCEPTOR GROUP and clearly 
state the issue of CDU that you require. No 
d<x u meiil.it ion will be supplied. 

Please use appropriate packaging, cardboard stiffener 
at least, when returning disk. Do not send back your 
magazine, only the disk please. 




ON THE DISK- 



2by2CMMmtDllOR 



Make large fonts, 2 characters wide by 2 characters deep with e; 



ROBERT TROUGHTON 



This new character editor is specifically designed lor 
making large fonts thai are 2 characters wide and 2 
characters deep. It is usual for the fonts to be stored in the 
format as illustrated below; 



By using the pattern filler, you Can create lots more 
character sets which loo's very different from each other, 
ln.ii all using the same base. Just change the patterns and 
re-till the 'blank-tilled' character set! DO NOT try filling an 

already filled character sel because the result will be very 



MAIN EDITOR 

KEY CONTROLS (or use JOYSTICK in port 2 to control 



USES OF THE UTILITY 

Originally the utility was written specifically for making 
character sets to be- used in deitius. This version feature no 
iacilities for ma kins; hires (single colour) character sets, but 
that is because I will be writing a totally different editor for 
hires fonts shortly. ( it'iei :han demos, tiie editor can also 
be used for many other projects. ..Text Pages, Games, Score 
Tables, Title Screens to name but a few. 

WHAT IT CAN DO 

This editor features 2 UNIQUE features, a 'Pattern F 
and a '1*1 Charat ler I vpandi-r', integrated into the 
editor. All the usual commands are catered for ; 
Joystick or Cursor control, scroll character in 4 direct 
character left, light, tup m bottom, reverse char; 



CTRL R 
CBMR 
CBMC 



DISK MENU 



cle; 



ie all tht 



:opy c 



THE PATTERN FILLER 

The best way lo learn how lo use this i.icility is to practice. 
If you have designed a whole 'blank Idled' character set 
(see next paragraph) ALWAYS save it disk, if you make a 
mistake in your patterns, you can then reload the set and 
fix your problem. 

A blank-filled character set is one which, quite 
obviously, has no fill pattern on it. There are 4 pattern 
designs, eat h of these will replace the colours in you 
'blank filled' character set. The 1st palter design replaces 
the black lie: colour (")!. the 2nd replaces colour 1, the 3rd 
replaces colour ..' and I he -Itv 1 pattern will replace colour 3. 
It is usual lo leave the 1st pattern blank, so press the '+' 
key to skip it. 



Select colours 

Alter colours 

Scroll (4 directions) 

flip left to right, top to bottom 

Reverse current character 

Reverse whole character set 

Clear whole character set 

Clear current character 

Copy character 

Swap colours 

Disk menu 

Pattern fill menu 



Load character set 

Save character sel 
Load 1*1 character se 

Directory 
Pattern fill menu 
Main Editor 



PATTEKN FILL MENU 



ON THE DISK 



ULTIMATE PASSWORD 
PROTECTION 

Another program protection routine gets a viewing for all and sundry to enjoy 



ROBERT TROUCHTON 



Imagine thai you have a program that you don't want 
any&dy else to use. What do you do to prevent them from 
accessing ii> Simple - you add a 'password' check to the 
front n' the nrngram. 

'n [his sl-od article I intend to reveal a Ihrm of password 
immi !ion ihj| even the most hardened hackei would have 
iroublf .11 c racking! (In fact, it would be very near to 
mpossWe to crack!) 



Everybody must know what a password is. but how can ihey 
he iised^ TK> most simple form of password-protection 

would look vr-neihing like this BASIC listing: 

1 INPUT "ENTER PASSWORD";A$ 

20 IF AS <> "KIPPERMAN" THEN NEW 

30 PRINT "PASSWORD ACCEPTED" 

40 ...rest of program 

It wouldn't take much effort (from anybody) to 'crack' rhe 
password from that program! Even by writing ihe above 
program in Machine Lode. Hie program would still be very 
easy to lie broken into! 



ENCRYPTION 



: A9 00 8D 20 DO 8D 21 DO 8D 06 02 20 44 E5 60 

If you disassemble thai, you will get the followmg:- 

LDA #$00 

STA SD020 

STA $D021 

STA $0286 

ISR $E544 
RTS 



Encryption such as thai will not be enough lo protect a 
pingi-arn (mm prying eye:.. VVIi.n you really need is a way of 
inking 'password pmleolioir and viirrypiitin' into one. 

PASSWORD ENCRYPTION 

The prnblnm ■.villi ihe password-prole'dion described above 
was that the pass- word actually had to be stored 
somewhere in memory. Howevei c.omplev vour program 
may be (using hidden (j.^Ol' opcodes, code- structures, or 
whalevei kind ui ,>i I', a need proclaim urn;-!, if ifie password is 
stored in memory - IT CAN BE FOUND! The same 
lobviouslyi applii.-, ii Ihe password is hidden on disk, in Ihe 
drives RAM. or whatever! So. ..What on earth can we 
possibly do to gel pasl btorrnp ihe password in memory??? 

Simple. ..Imagine Ihe password 'GRUMPY'. The ASCII 
ei|oiv,"ilent to this is: 

: 47 52 SS 4D 50 59 

We could use ihese values as ENCRYPTION CODES. We 

would FOK ihe first byte of a program with 547 2nd byte 
with S52, 3rd byte with S55, etc:... The 7th byte would 
obviously be EOR'ed U %4. ^starting the series). 

All thai now needs ro be dun- k lo add a short 'header' to 
[hi- encrypted program winch asks for a password, and uses 
Ihe ASCII values oi the password as DECRYPTION CODES 
(used in EXACTLY ihe same way as encryption codes, using 
the EOR command again!}. If the correct password is 
5e decrypt! 
form. If the wrong password w L . 
enlered, (hen the program will be convened lo JUNK, and 
the compuler will mosi likely crash! 

I have provided a small (and very simple) utility which can 
be iisi.nl to eneiypl BASIC programs. To password- protect a 
program, just lulluw ihese simple procedures:- 

1 . Load the "ENCRYPTER.SYS" File (,8,1 ). 

2. Load the program to be encrypted. 

3. SYS 491 52. 

4. Enter the password you wish to use - max.1 6 chars. 

5. Wait while the program is encrypted. 

6. Save out Ihe resulting program as a BASIC file. 



: 56 FF 72 DF 2F 72 DE 2F 72 79 FD DF BB 1 A 9F ENDING NOTE: If you Password- Encrypl a program, make 

sure you remember whal the password isl! - If you destroy 
you were m dissemble thai, you would end up with a lot the original lilt and roiyet what Ihe passwoid was, you can 
JUNK! (Soil is therefore a simple form of encryplionl. consider your program lost' forever!!! 



ON THE DISK- 



SECURE 



Protection, Passwords, Encryptioi 



lable tools for the programmer. SAKIB KHOKHAR presents his 



How often have we all said, "I wish I could propel my 
Basic program from [irying cyts" or "It only I could make 
things dil'licuh ioi people lo see mv cudein;^" Well him 
you can. In ihe past CDU has published various 
programs lor doinj; [list such a thin);. However, like .ill 
magazines, new readies and programmers are coming 
along every day. Therefore, at the risk of going over old 
ground I give you my version of "SECURE" 

SIMPLICITY ITSELF 



Before you try t 
it has the line 
following lines 


protect your Ba 
umber zero (0) 
r something sim 


ic program, m 
1 suggest you 

ar as the first t> 


of your program 






REM 

1 POKE774,226:POKE775,252 



).M i voi 
you want to LIST your program, ll 



Tin-' set ond line, line number I is NOT essential, but will 
give some added protection. The two POKEs in line 
number 1 will perform a system reset is someone should 
use ihe LIST command. Once you have protected your 
program with SYS49152 you can SAVE the program in 
the normal manner. Once you re-load and RUN your 
now protected Basic program, the RUN/STOP key Is 
disabled and the RESTORE key will perform a system 




NEW [am[<:.\ ,\?im) S(.ki:i-:n i;lms| t 



[<'f.4 I'KIVII-.Hsl 



( .M.s. """ = i ; , F ; 1 ; , :„" , ;>;'„iT!,r ,,S| -tw 

Kl^ iivn.-i.i.si.ai j 246 



dlphavite 



EDITORIAL ASSISTANT 

VC Magazine is looking for a young, enthusiastic 

games fanatic to become a VO- 1 Editorial Assistant. 

The ideal applicant should have basic writing 

skills, would enjoy being wacky at shows, and 

games. 

If you feel you could better the country's top 
C64 title, apply in writing to Rik Henderson - The 



CLASSIFIED SALES EXECUTIVE 

An excellent opportunity has arisen for a classified 
sales executive with at least 6 months experience 
to handle classified sales across 3 Commodore 



o The Advenisemcn: 



KA.43-5 



ON THE DISK 



KARE AANESTAD 



An unusual and useful external operating system for your C64 



KA43/5 open-, up the operating system of your 
Commodore 64. li give 1 ; you i ompri'h(-iT.ive internal 
commands and opens up lor external commands. The 

internal commands are ,is you would e\pecl, readily 
e\er li I al lie. "I hi- external commands .no .iutomalically 
loaded from the disk drive before they are executed. 

ALL ABOUT KA43/5 

KA43/5 is a relocatable machine code (MO utility. It will 
highly enharnc- the rooperation between your computer 
and any Epson tor IBM) compatible printer. The printer 

can either be connected to the CBM Serial port or lo the 
User port. In the latter case the User port will act as a 
Standard Parallel Centronics port and the only hard-ware 
required is a simple straight through cable. Any 

i Ikil-.K lei evi II I, -IT lie' lied ( -,.;mi '.<■!■- i .111 he | .. r i r ■ r : li 

with high speed. TeM and h i u. h resolution iHires: graphks 
can be intermixed in the same document. KA-1 t/5 goes 
further and is highly valuable even without a primer as il 
eases and intends the use of the di4; drive. New i-'lernal 
commands can easily be added al any time by the user 

KA43/5 can safely be used as an utility for other 
programs, even ether utilities. KA4 '■ Hedges itself into the 
other programs and should therefore, if possible, be I he 
last one to be initiated. All KA43/.i commands can be 
u^ed both in direct and program mode except after an IF 
THEN command. 

Load and run KA43/5, Choose between Serial and 
Centronics printer and locate the MC-utilily preier.ibly at 
lop of Basic RAM! If you choose this location, the 
program will lower the necessary pointers to protect 
itself. If in doubt go for the default values. Turn on any 
printer. You can now use OPEN 4,4 and PRINT#4 or 
CMD4:LI5T as normal. 



COMMANDS FOR PRINTER 



(LEFT ARROW)C0 CBM or your own defined characters 
printed exactly asused on the screen. The control codes 
you can use are CHRSCIB) and CHR$(146) for RVS 



ON/OIF, OIRSM4J and CHKSil\i lor l\pand ON/OFF, 
CHRSUli or CTKI U for toggling Underline ON/OFF, 
CHRS'H.' tor reduced lim-spacing 124/216") and CHRSi") 
or CTRL C for Hires (parameters as presel by the (LEFT 
ARROW}Gm,h,l command)) intermixed with 

[LEFT ARROW]C0,>; As above, except printer bit map 

density changed to x (default "b) for both texl and Hires. 

Consul! your printer manual. Try 76+128 if you have a 

Serial printer set for PET ASCII and not Standard ASCII (if 

so also use (LEFT ARROWJC3 when not in (LEFT 

AKKOVVlCOmode)). 

(LEFT ARROWIC1 Standard printer characters, 

upper/lower set as on screen (default). You cart use yout 

printers conirol codes. 

(LEFT AKROWIC2 Standard printer characters with 

forced ASCII conversion. To be used when you will 

ensure character conversion from PET ASCII lo Standard 

ASCII. 

(LEFTARROW)O Standard printer characters, emulation 

mode i.e. no character conversion. 






tch the computer off. Secondary address of (he OPEN 
statement for device 4. the primer, have no effect. Listing 
of a program may require that you use (LEFT 
ARR< iWJCO. All Commodore control codes will then be 
printed. 

The Character type mode will be disabled by 
Warmstarting the compuler (e.g hit RUN/STOP and 
RESTORE). Usually this will not disable the wedge. It is 
therefore easier to press: (LEFT ARROW)C1<RETURN> 
lhan to make a SYS call to reslart. 



SCREEN DUMPS 

(LEFT ARROW1C Graphic dump of high-resolution 
screen. Can also be used lor Multi-color, but you loose 

the colours. Keep RUN/STOP pressed lo slop printing. 
(LEFT ARROWJCm As above with left margin set to m. 
Default is 0. 

(LEFT ARROWlCm.h As above, bit-map screen from 
location 256 - h [i.e.h=high byte). Any value can be used. 
Most used „ilues .in- VI. MM, (default). I 60 and 224. 
(LEFT ARROWIGm,h,IL Gives number or graphic lines to 
be printed. Default is 25. This command sets the 



ON THE DISK- 



parameter:; and returns without printing. 

(LEFT ARROWik Copy of texl screen. You will get an 

exact copy as KA4.S/5 automatically seeks for ihe screen 

location and chr. set. Keep RUN /STOP pressed to stop 

printing. 

(LEFT ARROWIKm As above with left margin set to m. 

Default is 0. 

(LEFT ARROWIKm, 1 As above with the one 10 denote 

reduced linespacing (24/216"). 

(LEFT ARROW)B0"T" Banner dump to screen of Text 

enclosed in quotation marks or siring variable. 

(LEFT ARROW1B1 "T" As above to printer. 

(LEFT ARROW1I Sets interrupl controlled screen dumps 

ON (does not work for Serial printers). KA43/S 

automatically seeks Ihc screen, il be te.\l or Hires. Use 

CTRL K for primer copy. Disable with RUN/STOP 

RESTORE. The command will normally not work on 

protected programs or programs which disables the 

RUN/STOP and/or RESTORF keys. 



to the same address are made with (LEFT 

Ak'KOW!A<RETURN> only. E.g. (LEFT ARROWIA49152 

<RETURN>. 

(LEFT ARROWIA Automatically seeks lor an installed 

machine code monitor. List from the monitor 10 the 

printer with : OPEN 4,4;CMD 4:(LEFT ARROWIA 

<RETURN> 



EXTERNAL COMMANDS 



DISK COMMANDS 

(LEFT ARROWID Directory is shown on the screen 

withoul erasing any Bast program. STOP the listing with 

ihe Space key. 

(LEFT ARROWIE Any disk Error slatus is shown, i.e. disk 

status channel. 

(LEFT ARROWIEd Change the disk device numbers of 

KA43/5 command'-, dto be a figure from 8 to 1 1 . 

(LEFT ARROWIE'C" Disk command, see your disk 

manual. Neither OPEN nor CL05E are required. E.g. 

"C"="R0: BETTER GOOD" which renames the program 

from "GOOD" to "BETTER". 

MC-SAVE & AOD COMMANDS 

(LEFT ARROW )M<Startadr.>,eEnd adr.+l>,"Name",<d>,1 

MC-save , d=1 for cassette and d=8 for disk. Load with 

LOAD"Name",d,1. 

Remember In reset the Bask pointers .liter a MC load 

with NEW<RETURN>. 

(LEFT ARROW :v\ <:. Ad r> Additional command. <Adr.> is 

the SYS call address and must be a figure. Later SYS calls 



addre 



laded. The 



!and ' 




LOAD"NAME",S,1 and the SYS number, with no Basic 
pointers altered. Thus the command will have the same 
effect as if already in memory. To recall an already 
loaded and executed command just press (LEFT 
ARROW)X<RETURN>. 

Parameters can be passed. Eg. (LEFT 
\RROW)X"AUTO", 10,10 <RETURN>. or (LEFT 
AKKOW;X,10,10 <RETURN>. KA43/5 will protect itself 
from hiring overwritten In an External Cummand with an 
OUT OF MEMORY error and it will deny to load a Basic 
program starling at normal 2049. 

LOCATIONS FOR KA43/5 

The best location of KA43/5 OPEN SYSTEM is usually at 
top of Basic RAM. This area is mosl often not used by 
any other program. A draw-back is that this may 
unnecessary reduce the space available for Basic 
programs. Ihc length of KA4.V5 is 2555 bvles. You may 
.iltemaiivelv locate KA4.I/5 in Ml K-\M -.r-i' wh. n- Hum 
49152 to 53248. If location 49152 is interfering with 
oilier programs, yon can choose 5;'i. ' ■ ■ J 48-2555). 

By I oca! in » KA41/5 at top of Basic RAM, the program 
will protect ilself by lowerim; ihe poiiilcrs ol Basic RAM 
top (=PEEK(55)+25fi'PEEKi5h.D. Start address (<Adr.>) 
will then be equal to this new RAM lop (normally 
30405). 

You may save the ML part by help of (LEFT ARROW1M if 
you want. 5YS<Adr.> to start up the program when it is 
loaded (and the computer is reset by NEW <RETURN>). 
If you at the same lime want the program to protect itself 
from Basic i.e. lower the IS.isk lop Ihcn S"i S<Adr.+7>. 
Be sure your printer supplies its own linefeed after 
carriage return (i.e. after RETURN or CHRS03) is 
received). Try to avoid using file no. 125 to 127 as they 
may be used by KA43/5. 

Wlien (LEFT ARROWJCQ, (LEFT ARROW1C, [LEFT 
AKKOWik or iLEFT ARRCJVVHi are in operation, KA43/5 
uses the first 2k of the RAM under the character ROM as 
a temporary store. This area is hardly used by any other 
program. 

l-.-'Vl i/5 will work with most programs withoul difficulty. 
but some programs may use all available RAM and then 
wipe it out. Let's look at some programs: 



KA19/2E BASIC locate KA4.V5 at lop ol Basic RAM. 
D-BASE KA9 locale KA43/5 at top of Basic RAM. 
SPEEtJSCRIPT 3.* locate KA43/5 at 50693. Load 



ON THE DISK 



Speed Script. POkL 24(11,147, RUN SpeedScript 
DOS WEDGEiby Cum mo do re doc 
AKR(JW). To change Ihis 10 . 
POkE<Adr.+H)4>,39 where < Ad r. 
KA43/5. All KA43/5 commam 
preceederf by ' ,e.g 'G. 
SIMONS BASIOnsert the cartridge, 
of Basic RAM. 



where <EXPRE55ION> is mandatory 
like the (LEFT and 'EXPRESSION' is optional 
(=SHIFT 7), 
;tart- address of After a command is loaded, a recall c 
s then lo be only :<left arrow>X', parameters' 

!KA43/S at top Eg. :<l.arrow>X~AUTO",l 00,10 



i lie made with 



POKE<Adr. + 1776>,x - x is number of Unas (LEFT 
ARROVVik will dump to ilk- primer i J =. bv default]. 
POKE<Adr.+2217>,x - Where x is ASCII value of printing 
character used bv 1LLTT ARROWS id 4 bv default]. 
POKE<Adr. + 904>,x ■ x is Control code used for 
underline (21 by default). POKE<Adr.+90B>,128 - For 
over line instead of underline. 

POKE<Adr.+1736>,x - Value of reduced linespadng i. 
ji/216" (24 by default). Disable this facility with 
POKE<Adr.+1705>,96. 

POKE<Adr.+2026>,2 - CBM K instead of CTRL K for 
Interrupt kopi leopy) lo printer. 

POKE<Adr.+2033:>,36 - And the prinlinj. starts with only 
a touch on the CTRL (or CBM) key. 
POKE<Adr.+1711>,234- Five bytes at your choice, from 
<Adr.+1729> to <Adr.+1733> will be sent ro the printer 
before the (LEFT ARROWIC, (LEFT ARROWIK and (LEFT 
ARR< IW1B1 commands and when using CHRSlfl) and 
CHRSI7] in (LEFT ARROWICO mode (i.e. commands 
reducing the line spacing}. The user port at the rear left 
sidf of the CHMb4 can lit- ImoLed lo a Centronics printer 
with a standard parallel cable. The same cable can also 
be used for Easy-Script, VizaWrite, Final cartridge etc.. 




You should always connect/c 

at the computer end when 

printer, and disconnect the power cord of the printer 

when connecting the cable lo the computer. This 

precaution will save wear on the IC IU2, type 6526) 

connected lo the User port. 

KA43/5 OPEN SYSTEM introduces a new concept for 

your CBM 64. You can now let the computer grow as 

you expand your library of external commands, [samples 

of external commands are: 

(LEFT ARROW)X"DELETE",1 00-300 

(IEFTARROW)X"RENUMBER",100,10,400-600 

(Renumber the old lines 400 to 600] 

(LEFT ARROW)X"OLD" 

EXTERNAL COMMANDS FOR OPEN 
SYSTEM KA43/5 



*X"EXTER'NAL COWHAND 1 ", "P' 

-g LOADS fi MC-PRC flN6 ..JUMPS TO FIRST 



9B 






EXTERNAL COMMANDS 

"APPEND","NAME , ",D r 

Where D=l for tape and 8 for disk. 

"AUTO",<linesiart>',step' 

Aulo linenumberini;. Cursor down to an empty line and 
press <RETURN> to disable. 
"BIG CHARACTERS" 

Prints- double height characters lo the text screen. This is 
achieved with the same text on two adjacent lines, the 
second time with RVS on. Use NORSK or another foreign 
font to configure the compuler for RAM based characters 
before you ei 



e start; 






ally a 



"DELETE", 'I ineno'-'lineno' 

deletes all lines between given numbers. 

"EASY LIST" 

prints CBM control codes as readable 

Repeal <l.arrow>X to turn off EASY LIST mode. 

"FILE-READER","FII.F"',D",M' 

Reads files, bolh SEQ and PRC, from disk lo device D 

where 3 is screen (default) 4 to 7 are printers and 2 is 

RS232C (OPEN file 125 before sending to 

RS2.i2C,eg.:OPEN 1 25,.'. .3 .tHKS-:8l + CHRt(1 ) for 1200 

baud. POKE<Adr. + 341>,2 if you use KA43/5 as this will 

let the the conversion from PET ASCII to Standard ASCII 

lake effect on the RS232C channel. Use <l.arrow>C2). M 

is mode, for only printable letters tall control codes off, 

default) while 1 gives all letters (transparent). LOCK the 

screen with SHIFT, and STOP with F7. 

"FIND", 'start lineno':<hunt> 



OIM THE DISK- 



Hunts express io 

for reserved Bas 

apostrophes (i.e. SHIFT 7). 

"FUNCTION KEYS" 

Finish key definition with left arrow for automatic 

'RETURN'. RUN/STOP RESTORE for reset. Start up 

without redefining; P< IKE7S8. 1 44:K)KE789,192. 

"HELPKA43/5" 

Help menu 

"KLOKKE"',hour:min:sec' WATCH 

"KlOKKE",B to disable iblank), but the watch keeps 

going. Only "KLOK.KE" to turn on display again. You 

should disable hi'Kin- SAVE'ing. Both hour, min and sec 

must be set! 

"KOP1" 

Dumps text screen to printer imiu; i In ■ ch.ir.u In font of 

the printer 

"MERGE", "NAVN".<D> 

Only for disk with D from 8 (normal disk no.) to 15. The 

merged files from 

the disk overwrites any lines in memory with the same 

number. 

"NORSK" 

foreign character set (others are also available on the 

system disk). The screen address is ',2214 (=:04'25hl. 

and the character set lies under the KEKNAL You can 

print out the character set with <l.arrow>G27,224. 

"OLD" 

Resets a lost BASIL program 

"REN UMBER'", si art ",step", line-line' 



"VARIABLE DUMP" 
Shows the variable; 
program has been run 



inly old lines betweer 




KLAJNT GrAKX3 O 



The Second Segment 



We started this series of useful routines with 
look at making your 'freezed games' behave better, 
overcoming some of the piliall- em ounlert-'d when using 
'freeze cartridges'. On this months disk you will rind the 
DYN KB BOOT program which we missed last month. 
Also on this months disk, along with the up and running 
programs we talk about in this article, are the 
SOURCECODE files appertaining to each of them. You 
can examine these sourcecode files with Your 
Commodore's "SPEEDY ASSEMBLER" or any assembler 
that is compatible. Alternatively, you can load the 
Machine Code and then examine it using a Machine 
Code Monitor. 

We will be looking at the following routines in this 

months issue; 

PERMANENT HEADER - An easy way of displaying a 



message const antlv on the top of the screen. 
UNIVERSAL VERIFIER ■ A simple method of skirting the 
restrictions imposed by the VERIFY command. 
CUSTOM BASIC - A bit of fun that allows you to play 
around with Basic keywords. 

The remaining 2 routines; SPACE INSERTER and LOAD 
ADDER will be covered in next months issue of the 
magazine. Until then, may I wish all of the readers in 
BRITAIN and the rest of the world a very happy 
CHRISTMAS and a prosperous NEW YEAR. 



PERMANENT IRQ HEADER 

This is a Machine (. ode progr.im which puts a message at 
the top of the display screen, and it stays there even 
when the screen scrolls. II k nu e lor a scrolling dal.ibase 
or direi lory, or even an ordinary l.l.isie iisling. As the list 
scrolls, the message flickers to draw your attention to it. 



ON THE DISK 



Load il and list It 

The program includes several KEM's which allow you 
to change ihe colour or message of the text, which in 
(his case must he r\.i< lly -111 char; alters lon.n lint I tiding 
spaces). You may use your own message in lines 70- 
110, but notice thai it is in screen code, not ASCII. The 
program only takes 106 bytes at location 900 in [he 
tape buffer. The Sourcecode may be used to place it 
where ever there is room for 1 06 bytes. 

Referring lo ihe Sourcecode, (he IRQ normally scans 
the keyboard 60 limes per second, and the vector 
IIRQVEOal $0315/0315 points to the roul 
which does this. It "updates the sol'twa, 
STOP key check, blinks the cursor, maint 
interlock and reads the keyboard" (Mapping th 
Commodore 64, Compuie! books). In this case th< 
IRQVEC is changed (lines 200-260) to point to ou 
routine al "MSG" (linen 2H0-370), which then 
lo SEA31 as before. The resull is thai ■MSG" 



il SEA) I 






330-350), and the colour ii 



a the sci 
) thee 



ir memory, Line 
e follows the message line. 
Line jou Lonunues io ihe original IRQ vector 
destination, which was saved in lines 150-100. 

The trouble wilh this is that Ihe letters appear in lower 
case only. If you PRINTCHR(14) you may use upper and 
lowercase text, but ihe message (hen curiums jj^phics! 
So, if you want to prim upper ,irul lower case, use lines 
400-430 instead of lines -160-550; this works because 
the text is now in normal ASCII characters. SYS900 
slarls the header, and you must SYS442 lo kirn it off (see 
lines 560-600). 

IRQ rerouting is a very powerful technique, and can 
be used for many other applications too, eg scanning to 
see whether a cerlain key is pressed, and if so, imposing 
some r>.tra command. In our case the "PERMANENT 
HEADER" can remind you how lo stop a scroll, pause 
it, or whatever you wish. This is useful when there is a 
long scrolling, and you have forgotten the original 



File 2 is opened in line 180, and file 3 in 185. A byte is 
laken from ihe source file in 190, and compared wilh 
Ihe destination file in 200. If they are ihe same it goes 
back for another livte until rilher an inequality occurs 
or the end of the file (ST=64), and the appropriate 
message is printed for each. 

This worked very well bui was very slow. The 
Machine Code version in "UNIVLRIFY/ML" more than 
doubled ihe speed of operation and made it 
unnecessary lo specify a filelype. The firsl part of the 
program is in Basic, for convenience, but the speed- 
dependent pari is in Machine Code following it 
(invisihlyi. It you only want results, simply put 
UMVERirY inlo your "musf utilities and use it freely; 
full instructions are ini luderl on the screen. If you want 
to know how it works and lo learn something new 
about Machine Code, read on. 

The Machine Code version turned out to be 
i iinnkferably more difficult than a simple Iranslation of 



the Basic lines. After opening files with SA of 2 and 3 


one would expeel that the following routine v 


ouldgel 


DRIVE.1 LDX#2;LFN=2 




JSRCHKIN ;OPENFORINPT 




JSRGETIN ;GETABYTE 




STASTORE.1 ;STORE.l=2 




|SR READST .SOURCE EOF) 




BNEOK ;Y:EXtT 




DRIVE.2 LDX#3 ;LFN=3 




JSR CHKIN 




JSR GETIN 




STA STORE.2 ;STORE.2=3 




1SR READST 




BNE V.ERR ,-Y:EXIT 




IDA STORE.1 ;RECOVER AS 




CMP STORE.2 ,-COMPARE BS 




BEQ DRIVE. 1 ;CYCLEIFSAME 




V.ERR (print "Verify Error") 




END (closes files and exit) 




the bytes and compare them; 





UNIVERSAL VERIFIER 

(By ELAINE FOSTER and LEO GUNTHER) 

The VERIFY command only works for program files, bul 
what can you do to verify SEQUENTIAL or uSf-K files; 
This problem arose recently for one of us: "Is thai file 
on the backup disk ihe revised one or not?" - The 
answer was "UNIVERIFY/BASIC. The working pan of 

180OPEN2,8,2,"(sourcename),(filetype),R" 
185 OPEN3, 8,3, "(destination name),t filelype), R" 
1<*OGET#2,A$:PRINT".";:IF5TTHEN220 
200GET#3,B$:ON5TGOTO22u:IFA$=B$THEN19f) 
210PRINT"(down)..VERIFY 
ERROR":CLOSE2:CLOSE3:END 
220CLOSE2:CLOSE3:PRINT"(downl..OK":END 



from the 
the new 

closes both files in the usual way (CLOSE and 
CLRCHN). If the bytes are ihe same to the very end the 
BNE after the Source READST goes to an "OK!" 
message, and then closes etc. The declination READST 
is slightly different, because if the destination file ends 
before the source one ihey are obviously different and 
the error message is appropriate. With a rather more 
detailed error trapping svslem this worked well as long 
as the two files (with different name) were on Ihe SAME 
disk. But when ihe files were on Iwo different drives it 
hung up after a cycle or two/and NOTHING could be 
done to solve It with CETIN. It worked in Basic with 2 
drives but not in Machine Code. Hours and hours were 
spent on ibis, bul without avail; if you have an idea 
why, please let CDU know!! 
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e problem was solved by using a different GET 
prator, namely ACPTR a! $FFA5. This gets a byte horn 
serial bus (not from the keyboard), like GETIN, But it 
ers from GETIN in two ways. It does not need to open 

ename is involved las -■■■■ 
e Command Channel ol the disk IIS) or the printer), 
,ii. be cancelled by UNTLK al JFFAB. Because 
NIVERIFY did need a -nunc and destination filename, 
e UNTLK was the pari needed here, lusl as GETIN 
to define an input channel, so ACPTR 
st be preceeded by TALK (SFFB4) and TKSA (SFI-%i In 
■ serial bus To send daw to the computer. TALK 
epares Ini bus ami I'kS.A sets the Secondary Address. 

, SECOND and UNLISTF.N are the sending 

equivalents (like CHKOUT); CIOUT is the equivalent ol 

Tims, after OPENing in the usual way (to 

efine the filenames and put ibcm into a table) and soon 

nfortunately, this did not work until (he Input Buffer 

■ cleared thus; 

UFFER LDY#U 

LDA#I) ;NULLBYTE 

OOP STA$0200,Y ;1NTO BUFFER 



...it. The various 
■■■ n-.Cd in irom Basic and the main 
led by SYS2B00. The result is that when you 

vll.rA the prompts (or number of drives and lor the 
lilcuaines it rapidly prints a dot for each byte compared, 
and gives either an OK! or VERIFY ERROR! for the 
normal situation. Where a disk is left out at a drive, or 
where the wrong filename is used a DISK ERROR! 
message appears. Therefote this is quite a user Iriendly, 
and relatively last, although lor a long le*l file it will 
take a while If can be used for ANY lilt i\| 
quite unconcerned wither a file is PRG, 5EQ or USR. 
The dots increase scan lime negligibly, and are more 
cheerful than staring at ■ l he drives 

chum. Hie) i only a few 

ilois appear before an error, you probably have the 
wrong file. 




;CLEAR 3 BYTES 



RTS 



; was inserted as ISR BUFFER just after ihe ISR 
UNTLK, This worked. It is worth remembering for this, 
nd for cases when no file name is needed it can save 
uchspa ■■■ See ANATOMY OF THE C64 fa a director) 
outine using TALK I. II may interest you to know that a 
wvellous debugging routine was found and can be 
nserted following the above program. 



PHA 


■STORE .A 


TAX 


■LOW BYTE 


LDA#u 


;HICH BYTE 


(SR LINPRT 


;PRINTS ASCII 


PLA 


RECOVER .A 



RTS 

■suit of Ihis is thai LINPRT (SBDCD) 
he ASCII (ie; ordinary number) of the two byti 

e low byte is in "X" and high byte " 
is obvious as you may ihink. If ,A=1, ISR CHKOU" 
■ou nothing, because CHRSil 
. CHRS1S) gives ■ ,. ti r md i your 

SCII 19 ($311 whici 

owc-rful debugging too en yo i i R ASCII 

lit that point, and it is " transparent", 
ugging Machine Code is hard enough lo prove the 
.:li if '.'I a good tool like this one. 




described 
changes to the C64's , 

have intercepted various vectors. This one is simpler, 
and it can be changed easily. The method: Basic ROM 
is transferred to the RAM underneath, that RAM is then 
changed by POKEing. This changes the Basic 
interpreter, and you can make il do whatever you 
please. You can fix various bugs of Basic 2.0 or you 
can fashion it to your own taste (if you have a 
disassembly of the Basic ROMI*l). The Idea is nol 
new, but here a very efficient transfer method is used. 

^iJiLDI Yft&ri.'l&'i^IrT; 



Line 50 of CUSTOM BASIC shows the si 
sequential ROM transfer which is usually se 
computer articles, it takes 37 seconds, which 
forever. Lines 100-130 are much faster, using F 
own mass-transfer routine at 41919 (JA3BF), wl 
uses often to move code. Without the REM' 
takes 2 lines, and even in Basic it is 37 tim< 
that it can be put onto the front er 
rdinary Basic program where you want the :i(\\' 
~ CUSTOM BASIC, with 
Therefore, 
50 of 



faster I 




- final Mat lime Code n 



s located al ! 



Once Basil ROM has been transferred lo the RAM 
underneath you have a very powerful tool. If you have a 
■ ■ rribly mapl'l and a simple idea ol Machine 
Code you can change anything you like in Basic. After 
the transfer has been made. Basic ROM is li i ■ 
POKE1,54 and then the interpreter looks at RAM which 
you i an change easily. All 0' the advantages of RAM and 
no viruses! Furthermore, il ran he done from Basic using 
only POKEs and perhaps a few DATA st 
routines are onl) suggestions, try your o\ 



ON THE DISK 



This program changes only five commands of Bask land 
plays willi a Word Table) bul others are possible. Fur 
Machine Code enthusiasts Inlet" REM's have been included 
la show HEX locations. 

Line 2 30 remuvts ver\ simply a majoi problem of INPUT, 
wliii.li < rashes if you use a comma or colon in the le\l, 
Willi this modification you may use any lev: you likelY 
Why should you want to have any 'jiroliibiled" characters 
for INPUT; Bul il vi.u do vou ran substitute (heir ASCII loi 

either or both of the zeros iri line 230. 

Line 310 allows you lo use "+" instead of ■',' between 
the numbers in DATA statements. Then, when enteting 
DATA from an article you can keep your fingers on the top 
line of keys, and between each number the little fingei or 
your right hand reaches over and presses the "+". This is 
nicer than inserting ihe commas during typing or later, 
and much simpler than various Machine Code solutions, 
■hange at one location (441 33)1 When 
it pages of numbers this feature is 
mly disadvantage is that Ihe new 
be read if the RAM has been 
hi. but for a long program it is 
II the other advantages of 

at awiul "READY" prompt to 

-e.place it by your name it can 

this is your program. Any 

ly fi characters lung :im. hiding 

: "~"-", "CMDe* " :■' 

limbers in the DATA 

Disk Drive or the 



ingle rhar; 

bKEing the appropriate AS! 
" 'NPUT used anywher 

n have the new prompt unli 

:d advantage is that when the 
message, the ">" at the beginning is replaced by 




HI00OPEN1,8,0,"S0:" : REM POKE1.54 

1010 FORN=0TO9:GET#1,A$ 

1020 REM IFA5=""THENA$=CHR$IU) 

10!iUPRINTASC(A$);:NEXT 

1040 CLOSET 

With a disk in the drive RUN 1000. Result: ?SYN 
ERROR, and the drive's red light will remain on. 
CI OSF I to turn it off. Now delete the letters RFM 
fine 1020 and RUN1Q0Q again. Now you will see ■ 
numbers, two of which should be zeros. Now KUN100 
to activate CUSTOM BASIC (use STOP at line fiStl lo 
omit the test), delete line 1020 above, and delete the 
letters REM from line 1000. The test will run without 
crashing. 

To use CUSTOM BASIC is wa ■ I 
POKE1. i-i in line 1000. This Is generally true: it n 
entered somewhere in a program (or in DIRECT 
before CUSTOM BASIC is used, but it will only need 
he entered once. In the listing it is in line 130. The same 
thing applies for Direct Mode; Enter POKE1.S4 once 
before entering something directly from the keyboard, 
and you will not need to enter it again. One exception 
applies however. If you are using a TOOLKIT 
CARTRIDGE the POKE1,54 MUST be ■ 
time used in Direct Mode. This is still an improvement 
■ >r the vector-interception methods, ' 

:ridges often override them completely. 



Ihout 

enter 
islhe 
lode) 
edto 





JILLEGAl QUANTITY ERROR 
READV. 

'ilh the modification used her you will have 

A; 

PRINTASCI"*) 


ELAINE (in this case). 

■ lovi.k If vim are taking bytes from Ihe disk, and 
an simplify your programs by avoiding awkward 
(and slow) correctors like; 

IFA$=""THENA$=CHRS(0) 

B=ASC(A$+CHR$(0)) 



ENTER A STRING CONTAINING PUNCTUATION ! 

HELLO COMPUTER: GOOD, OH: 

IN 71t)=HELLO COMPUTER: GOOD, OH? 



[SYNTAX ERROR IN BOO 



the punctuations: Vou see how the delibe 

line 800 used that SYSTEM rot • too 

notice that it does not produce a carriagi 

shows Heady where that print c 



This 



seful as the 

■ i- remove all SYSTFM ■ 
after il is working. And o' 

d all REM's from the vei 



ON THE DISK- 



OTHER ROM CHANGES...? 

modi fit ill ions lo Basic, hut [Jo no! expect lh.it they will 
always work. Would it be interesting lo change the 
STATEMENT TABLES which arc located from 40972 to 
41373 ($A0OC-$A19D)? You could then make the 
machine respond to your own version of Basic, (•■ample 
using po (NOT pOl instead of POKE, but it does not 
work: it insisted on consulting ROM, not RAM. On the 
other hand it was passible to change the ASCII text of 
Basic Error Messages, from 41374 to 41767 (SA19E- 
SA327). Vou could for instance, change "SYNTAX" to 
"SILLY" or even "SEXY", but there seems little practical 
use for that, although in line 910 "SYNTAX" has been 
changed lo "WORE*" if you do not like the former. The 
simplest way to make any tenlal ive changes is 10 use a 
Machine Code Monitor to change the RAM after 
transferring the ROM lo RAM, exit the Monitor and test 
the result. If you like il then you can build it into your 
own CUSTOM BASIC by POKEs. 



OTHER IDEAS 

ii seemed as though ■ could be useful lo build the 
"SYSTFM" ie,i into I : I. otherwise useless?, to tell you 
the line number when LET was used. It worked, but 
inserting (he necessary IMP $BDC2 at $A9A5 also ruined 

every :lei nt-i: -. n at) •- Ii seems (hal when you enter N=2 
(or elcl it actually goes to the LET routine, which seems 
not lo be so useless after all. 

A friend suggested changing ihe cold-start message 
from ■— COMMODORE 64 BASIC V2 **»* to your own 
choice. That message is located from JE4.SF to $E4AB, 
and is primed from ROM when Basic is initialised at 
Power ON (or Reset). But although you could put your 
own message into the RAM underneath that, if you 
wanted to print it you would have to turn off the HIKi >M 
at SEOO0- at location 1. This could be done by 
POKE! .52. Try that, and will see why not; it hangs up. 
The reason is that when you turn off HIROM with a 
POKE win turn olf Ihe abilitv ' " the system in uncle' -la ml 
the POKE, and il goes crazy! You can do il in Machine 
Code, but when Basic is initialised il always reads (nun 
Kf. liVl anyhow, ho nolhing would be done. Too bad. Enler 
SYS58260 to show this. 

So, experiment, bul do not be surprised if you have 
difficulty. If you succeed, let CDU share in your 
knowledge. 

RAM CHANGES 

Try adding this lo CUSTOM BASIC; 

660 POKE56341,40;POKE650,128 

The first POKE speeds up the cursor blink to a more 

useful rate (default i~ <i4': ihe second one allows all keys 
to repeat, also useful. Within a program Ihese show up in 
INPUT statements, bul they .in 1 still I here when you iisl 
the program, and are convenient when debugging. 



USING MACHINE CODE 

C.BASIC LDR on the disk does all of Ihe above rather 
faster (nearly instantly! by using Machine Code. The 
REM's show where you can make changes. It includes 
ihe modifications 1-5 of CUSTOM BASIC." This is a Basic 
loader, and when it is run ii will pul the Machine Code at 
location 820. ami SYS820 activates it. If for some reason 
ihe program ua-he:. rear rv.iie again eilher by SYS820 or 
POKE1 ,54 (bul RESET will destroy 8201 

This loader may he marie pan of a program, but it does 
occupy 471 bytes (omilling REM's). Lines 100-610 of 
CI 1ST' )M BASK" require only 208 bytes when d-remmed, 
whi< h is aelually smaller, ami il i- easy merely lo include 
ia d-remmed) CUSTOM BASIC in your program (lines 
100-610). On the other hand, the actual Machine Code 
oi Ihe loader take only 71 bytes. Il" you save it to disk as 
Machine (.ode jnt} then reload it b\ your main program, 
il will nul take any room in ihe Basic area, and of course 
it will run much faster. 

The Machine Code routine does nol lake any room 
from Basic, but as il stands il canii' >l lie moved to another 
region. Ihe Source code is hit luded on the disk. Listing 1 
below shows how to s.tve the- Machine Cor.ie e.- -.li-l.. 
listing 2 shows how lo load il into your main program. 



LISTING 1 

(Saving the MC to disk) 



290 PRINT"[down] SAVE TO DISK? ":WAIT198,1: 

GETA$:IFA$o"Y"THEN320 
300 OPEN1,8,1,"BASICMOD(820)":PRINT#1, 

CHR$(52)CHR$(3); 
310 FORN=820TO890:PRINT#1,CHR$(PEEK<N));: 

NEXT:CLOSE1 
320 SYS820:END 



LISTING 2 

(Loading MC from Disk) 



{"I - Useful referances; 



c program, and must 



MAPPING THE COMMODORE 64 BY SHELDON 
LEEMON {COMPUTE BOOKS) 

THE ANATOMY OF THE COMMODORE 64 BY 
MICHAEL ANGERHAUSEN el al (ABACUS PRESS) 

That concludes Ibis mouth-- tillering. I'iesl month we will 
give you the final two routines, namely, 
LOAD ADDER and SPACE INSERTER.. 
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A letter, a letter, my 

kingdom for a letter - 

JASON FINCH" circa 1990 



MY COMMENT 

Before I start sifting through (his month's mailbag I 
would like tu wish each and every one of you a happv 
CHRISTMAS and NEW YEAR. If by the time you read 
this it has all passed, then I hope vou had a good time. 
Secondly, I thank Mr L. J. TODD OF HENLOW, 
BEDFORDSHIRE for forwarding to us an original < o\n 
of the HOME ENTERTAINMENT CENTRE, free of 
charge, which I immediately passed on lo MR WRIGHT 
OF SHROPSHIRE who expressed an interest in a 
computer version of Ihe game of Bridge. It is very 
pleasing when such results are obtained. 



FINDING THE 1581 

Dear CDU, 

I am currently looking for (he Commodore 1581 three- 
and-a-half inch disk drive, with no success. I read in your 
article on Adventure Writinglh.il you have a 1581, so I'm 
asking il you know where I can buy one. as nobodv in 
Stevenage appears to have heard of it! I also required 
help finding a copy of the game "MISSION OMEGA", a 
review of which was printed a lew months ago, but as yet 
1 cannot find it anywhere. Please help me locate a copy 
of this game, as I liked line sound of it. 
MARC BANCS, STEVENAGE. 



Dorkta, 

I obtained my 1581 drive from FSSL and I am quite sure 
that they still slock them. There address lor Ihe purpose 
is FSSL, Masons Rydc, Defford Road, Pershore, 
Worcestershire, vYKln I AZ. The drive costs around two 
hundred and fifty pounds bul I would telephone them 
first on OJHb-553153 to check details. With regards lo 
your second point, all I can do is ask if any of the 
readers has ever seen such a game in their local 
computer store, or alternatively if an owner of a 
computer slon* would like to write, I would be phrased 
lo pass on the address of Ihe store to Marc. 



BORDER SPRITES 

Dear CDU, 

Could you please tell me ihe secret to obtaining sprites in 
Ihe upper and lower borders. Also I read in an article of 
yours that there are only six key bytes used to get sprites 
in the side borders. What are they and how do I 
incorporate them in a program; I understand the 
concepts ol raster-sun nilenupls and have a working 
knowledge ol assembly language. 
ANDREW BROWN, HULL 



Dear Andrew, 

You correctly identify that raster-scan interrupts are 
important. Vou must first set a latch at SF9 to carry out 
the instructions LDA #$13, 5TA $D011. This would 
usually "shrink" the screen vertically but done at the 
right place it will help lo get rid of the border. You ihen 
need lo sel another latch at aboul 532 to carry out the 
instructions LDA #11 B, STA SD011. This then puts the 
m ee ' -i.'c k to ihe right length. Having carried out those 
s mple insi- , i tions at the two specified addresses. 
end ne. ..i course with a IMP SEA31 or something 
similar, you should be able to get sprites in Ihe Upper 
an:i lowt i Imrrfera. Getting them in the left and right 
!ss complicated in terms of code used, 
bul il - '.i' more complex in aclual reality because 
extremely precise timings are required - down to the 
very cycle. The six key bytes are given by the 
inslriu lions l.'ltC SL1016, followed immediately by INC 
SD016. Done al Ihe riidil instant this will open up a one 
pixel deep "hole" in the side borders. This must be 
repeated however many times you require wilh a 
sufficient lime delay in between. Bear in mind that 
displaying the sprites Will extend that delay anyway SO 
you need to experiment wilh ihe sprites displayed 
where you want them. It is impossible to say exaclly 
what the timings vou require will be because il depends 
on a number of things. I suggest thai you have a look at 
some of the programs thai have been published in CDU 
to see how ihe programmers have got the sprites in the 
lefl and right borders there - but don't hack out any 
code byle for byte and use it in your own programs 
remember, i hope that information will at least set you 
on your way. 
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MEMORY SCANNER 

DearCDU, 

Please could you help - I am unable to gel the 

results with the "MEMORY SCANNER" utility 

whenever I have tried lo use it I finish up with 

showing the "MEMORY SCANNER" program be 

but nut the adventure. Any help or advice you 

would In' ■,:km1;v ,i|ii.iri-i Midi. 

ROBERT MARSH-HOBBS, NORTHAMPTON. 



Dear Robert 








When you r 


jii the program the s 


reen will fill with a 




ymbols a 


s the valu 


s in the top left is 


incremented. When tin- 


screen is full, the number 


will be 840 


Y.iu then 




one of the function 


keys as shown in the 




of the display. To 


continue reading the n 




hould press F1 . The 


characters o 


1 the screi 


n will then be overprinted with 




d the valu 


e should in 


rement from 840 10 
F1 to continue. You 

ng regarding the 
ything further about 
jle adventure in the 
program for the first 



LETTER MAKER 



DearCDU, 

I am having a problt 

problem is how to get 

all I am getting is bla 

please explain. When I 

I get the disk title and men some menames i 

but after this it tells you to press a key for thi 

what is puzzling me is the letters are then in colour. 

when I press any key for the menu I am back tri the bl. 

screen and white lettering. I hope that you can help 

solve this problem. 

IAMESMCNAUY, KRIKINTILLOCH. 



ith "LETTER MAKER". My 
■xx in colour. At the moment 
id white lettering. Can you 
, the letter "D" for Directory, 

some filenames all in white, 
: menu. But 



if you wanted all te\t lo be dis-p laved ir vellow then you 
would load the program, enter POKE104&2.7 and then 
type RUN. I hope I have been of sc 



DRIVE DEVICE 



second -hand 
nd MPS801 

printer as well. I Jnfoilunatelv neither the printer nor the 
two drives had any manuals. The 1571 drive (used 
mainly in 1541 mode) is set to device eight and I have 
the 1 581 as device nine. Sometimes it is preferable to 
switch the devii <■ numbers, thus giving me the three-and- 
a-half inch 1 581 drive devk e number ev.hl and the 1 571 
number nine. However, this is very tedious flicking 
switches each time. The person who sold it all to me 
showed me ihe switches on the backs of the drives, but I 
now understand that there is also a software method for 
i hanging the device numbers hut. .is I said, I do not have 
ihe drive manuals, and besides, if the 15B1 was made 
device eight how would I access the 1571 to make it 
device nine, as then there would be two device eights? 
Please shed some light on this subject for me. 
DAREN POOLE, LEEDS. 



Dear Daren, 

There is indeed an alternative method for changing the 
device numbers of the drives and it is referred to as 
"sol'iwiring" the drives. The trick is to incorporate 
another device number - device ten. You change the 
1571 from device eight to ten, then the 1581 from nine 
to eight, and finally the 1 571 frojn ten to nine. You are 
then left with the drives having opposite device 
numbers, wilh no errors being generated due to two 
drives having the same number during the proceedings. 
T:ie melhnd Mi changing I lie (k-.ii.e -nr.-i:- r is < H'l.N 
15,od,15, "U0>"+CHRS(nd): CLOSE 1 5 where 'od' and 
'nd' are the values for the old device number and new 
device number respectively. To show you exactly how 
to do what you want I have written a short program that 
has been included on this issue's disk, filed as TECHNO 
PROB. Run the program once to switch the drives 
around and then again to switch them back. 



Dear lames, 

It is not possible to display the le\t for your letters in 
different colours due to the way that the utility has been 
programmed. The characters, you will have noticed, are 
all the same colour, and that is in fact colour number 
fifteen - light grey. You can if you wish alter this colour so 
that all the writing is displayed in. say. green or light blue 
or something, but it is not possible fur different words or 
lines to be in different colours. To alter Ihe general text 
colour simply load the program and type POKE10462,fl 
before running it, where 'n' represents a number between 
Oand 15 corresponding to your desired colour. Therefore 



PET PROBLEMS 

DearCDU, 

I think your magazine is better than most, catering for the 
more serious computer user, which is what I want to 
become. I think your letters page or TECHNO-INFO is 
excellent - please do not i harige your helpful attitude, as 
this feature alone will want me to go on buying your 
publication. What I want in a magazine is one which will 
provide me with answers to problems tr 
when trying to use my computer for more practice 
than playing games. I have an 6050 dual drive as \ 
a 1541 and an 8032P printer. I have bought a 
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interface to enable me id use Ihe disk drive and the 
printer but most programs wouldn't load with the 

interface connected. I have nuiv bought ,i differem IE-HE 
mterface and program will now load, but the print 

about one hundred pounds on trying to .net Ihe printer In 
work with commercial software. What is the point oi me 
mentioning this: Well, these are the sort of problems I 
hope can be ,in B wriecl bv m,[g,i/'ni-s , u < h as yours 
BRIAN COLLEY, BRISTOL 



Dear Brian, 

Tha-fc you very much for nil your kind comments about 
( 1)1. and TECHNO-INFO. It is nice to know that the 
v-o'k . appreciated. From your letter I gather that you 
haw -«i" been able to use the printer with your print 
utilities nd so I am wondering whether you have 
ihirkpc : mi the printer is device number four. You may 
have std i from BASIC as a different device number, 
Dill I don't know as you didn't supply those details. It 15 
esse, ilia, S.-.JI the prinlcr is device number four and you 
can check this by entering Ihe line OPEN.4,4: 
PRINTff4,"TEST": CLOSE 4. If this prints then there can't 
really be any reason that I can see for your utilities not 
to work, providing they don't require complicated 
tilings like the printing 01 graphics. It may be that the 
commands required In the printer ,ire different to those 
given nowadays by commercial software, tor ev.imple 
the code to enter bit image mode may be completely 
differenl - I do not hide the fact thai I am not fully 
familiar with the old PET printers and drives, although I 
do know that the drives are not 100% compatible. I am 
therefore surprised that you can even get recent 
software to load on the drive due lo the protection (hat 
many software houses now use thai are designed to only 
operate with the 1541 and compatibles. I confess that I 
am not entirely sure whal you can do further in the way 
of the printer because you haven't supplied me with any 
technical details or the programs that il won't work 
with. As I say, though, check Ihe device number and fhe 
commands that it requires to see whether it is entirely 






PASCAL 

Dear CDU, 

Please could you print in your magazine a request for a 
version of PASCAL on disk for Ihe Commodore 64 
because I am studying A-Level Computing and that is the 
language that we use. Thanks and well done on a great 



PRINT DRIVERS 

Dear CDU, 

I read with interest how helpful you are in answering 

queries in CDU. I am hoping you can solve my problem". 
For many years I have had the excellent OCP 
ADVANCED ART STUDIO, yet I have never been able to 
use the print option. As you may know you must 
coniigure ihe program to your printer. In despair I have 
Iried everything with no success. My printer is the 
Commodore MPSl.'^O. It mn use either seven, eight or 
nine pins for dot graphics. I have tried every variation I 
can ibink of, yet I cannot get the program to print the 
pictures. The program always locks up. With CEOPAINT 
I have no trouiile using Ihe MPS80I print driver. I have 
used the MPS801 configuration with the OCP but still no 
go, J have written to Commodore - as Usual, no reply. 
Also 10 ihe distributors of ADVANCED ART STUDIO - 
.ig.nn no reply. You are my last hope. Can you supply me 
with the informal!. in lo configure the program corrective I 
•■•■"■■'Itl be 1111 -1 grateful il vcm could help. 
DAVID MEOLAND, CHESHIRE. 



Dear David, 

I can safely assure you lhat if you go through the 

configuration process simply pressing RETURN when 
presented with each question ihen the resulting file will 
be correclly configured to the MPS801 and you will be 
able lo print You must have done something wrong in 
the past when configuring Ihe driver that was loo small 
to nolice. Unless your printer is faully I can definitely 
say thai reconfiguring the program will work - just go 
through every option very slowly and check and 
recheek belore pressing RETURN lii.il your finger hasn't 
slipped ,-ind hit some other ke\ by accident. I wish you 
luck with the new driver. If that slill doesn't work then 
your program may lie corrupted. If that is the case then 
please feel free to rewrite telling me whal happened. 



MEMORY EXPANSION 

Dear CDU, 

I am very interested in a memory expansion for my 64. 

Do you know of such a syslem? And if so, could you 

point me in [he right direction. Basically I'm alter Lister 

everything lu ith i, ons as well if possible). 

IM MORRIS, THE BRITISH FORCES. 



Dear Neil, 

Your wish is my command - if anyone has a copy of 
such a programming language for sale, or anvone 
knows of where such ,1 thing could be obtained, please 
send all relevant details to Ihe TECHNO INFO 
headquarters - address at the end - so lhat I may pass 
Hiemon to Neil. 



There is a very worthwhile system available for Ihe u4 
lhat gives you the use of icons lo operate such things as 
word-processors, a spreadsheet, graphics package, 
desktop publishing package and many other such 

utilities. Tin' software system is called GEOS, short for 

i.ii.-i|.'liii In- ■:* n- < i ■ ■ 1. ■■ ■-■,-!, ■!!■ ,: i, 1, ,i .:,.. 

In the UK exclusively from FSSL. You should write to 
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them at ihe address v. hicrh I a.ave n im hrsl repk sai in;,; 
that you wish lo purchase CEOS and the 1 750 Clone, a 

ci g, iii.l it- i nv ii ■. ■ .ii.i'--ii .!■. ■ r • ■ ■ i 
quite a hit, or a similar RAM Expansion Unit (REUi. I 
should think that the company will be only too pleased 
to forward their latest GEOS Catalogue to you. 



HARDWARE HASSLES 



■Ive, and that is: I have 
and a I550C printer 
ot work at all with the 
'.. Consequently 1 have 



DearCDU, 

There is a problem that I cannc 

a 1541 disk drive (working gt 

(also working great) but one w 

other switched on .it the same 

to keep switching off and on 

print a directory. Please can someone more 

knowledgeable than iiivselr come to the rescue!! I own a 

64 (circa 94), a 1541 (II) and a new 1550C printer, and 

also a POWER CARTRIDGE which is a great help in, 

amongst other [hings, renumbering. 

GERRY SMITH, CHESHIRE. 



Dear Gerry, 

The only thins thai I could suggust is that you check 
thoroughly the serial connections between the 
computer, the drive and the printer. Try first hooking the 
computer to the drive and then connecting the drive to 
the printer, and then try hooking the computer to the 
printer and then the printer to the drive, rhi- will check 
to see whether there is some sort of daisychaining 
problem. Are you sure that the extra cable that you use 
when both are connected isn't damaged; If everything 
still doesn't work, try disconnecting the POWER 
CARTRIDGE. Then add the drive and printer in that 
order and check, then disconnect everything and hook 
them the other way around and check. Try just the drive 
on its own but with the two different leads. There is no 
reason why the two shouldn't work together unless of 
course there is some problem with the connections 
inside the printer or the dove, thus preventing a chain 
through either the printer or the drive to the olhei 
peripheral. All these things need to be checked out. It's 
not really a problem that can be pinpointed in any nne 
thing I'm afraid. 



MICRO MUD 



DearCDU, 

"MICRO MUD". Unfortunately it was evident" thai 
someone had tried to copy the disk and it had erased 
itself. I was lucky enough to gel my money back. The 
problem is that although I have made exhaustive 
enquiries I have not been able to trace the publishers or 
the producers - VIRGIN GAMES LTD and MOSAIC 



PUBLISHING LTD. Do you know of these companies or 
where I can obtain a copy of this intriguing game? Maybe 
one of your readers has one lor sale. Can you help me 
please? 
U.BRITTAIN, KENT. 



DearMr.Brittain, 

Unfortunately I do not have the address of either 
company and I am unaware of a company from which 
you could purchase the game. As you said, perhaps a 
reader has a copy for sale. If so, I would be only too 
pleased to pass on any relevant information that I 
receive to you. So if any of you readers do know the 
address of either company or have a copy of the game, 
could you please let me know. 

EDITORS BIT!! - VIRGIN GAMES LTD can be bund at: 
2/4 Vernon Yard, 119 Portobello Road, London W11 
2DX 



ASSEMBLERS 

DearCDU, 

I'd like to ask a few questions regarding assemblers. I 
have one at present but it does not have any functions 
like line numbering and labels and I ho such. It just allows 
assembling and disassembling of code. I would like to 
know where I can obtain a copy of an assembler that 
allows line numbers (ie. 10 LDA #S0O, 20 STA...), 
supports labelling i.STAKl I DA S**««, CMP Sxxxx, BNE 
START), allows names to be defined for numbers 
(BMPAGE=S0400, LDA #$IM), STA BMPAGE), and allows 
data to be entered in decimal form (LDA #27 instead of 
LDA #S1 B). Please send me any details that are relevant 
for the 64. 
MOHAMMED SAVED, LANCASHIRE. 



Dear Mohammed, 

What you have got is actually termed 'a machine 
language monitor'. It only allows the basic sort of 
entering of code that converts itself instantly to 
numbers I would imagine from whal you have said. An 
assembler is something totally different whereby you 
enter the code lost like a BASIC program but with each 
command on a separate line. You then issue a 
command and then the assembler reads the program 
and analyses il in usually two or three passes, whereby 
, ii !■-,■ I- id p.i. : , !■,.■ |-;r-- »;.;■■-:■ *i K ■: ■:'■■ i -i ■ - -■ I lo n„n hinc 
code. An excellent assembler was published in CDU a 
little while ago, called the 6510+ Assembler, It was 
published in Volume 2, Number 4. To get hold of a 
copy of that disk I would write to Alphavite requesting 
a copy of a magazine beyond III a I available from Select 
Subscriptions. 
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TIP OF THE MONTH 




NOW IS THE TIME 

TO CATCH UP ON ISSUES YOU HAVE MISSED 



VOL 3 No. 12 OCT 90 
ROLL'EM - An example of using 

COLOUR MATCH - A short utility 
the C 1 28. 

SPREAD-ED - The third in the ED 

RASTEREDITOR - Put those raster 
lessons to good use. 
ADDRESS BOOK - A somewhat 
unusual address base. 
SUPERSORT b4/12B - Sorts have 

SPRITE EDITOR 1 28 • Another ulil 

for C128 users. 

GRAPH-ED - The last in the 'ED 



VOL4Nn. 1 NOV90 

WAR AT SEA - CDU version of 

battleships. 

FULL DISK JACKET - Easy disk sleeve 

NEAGOX - Blast everylhiog that 

NUMDEF - A Basic game to test your 
reflexes. 

ok through 



ML.MOKY SCANNER -Lo 
memory the easy way. 
MONEY 64 - Budget plan 



ng for the 



language tutorial, 

SCREEN DESIGN 
update to this excel 

BETTER BACKUP - I 



CODEC.EMS-Afewvi 
useful machine code routines. 

MULTITASKING C128-The 



CALENDAR C!2tl - No more buying 
calendars with this utility. 
GOMOKU - A nice variation of that 
pofiul.'tr board game GO. 




ON THE 



32 SXM ON THE C64 



We present a neat utility that enables the i 



n the Cf>4 written by MARTIN PIPER 



Your trusty Commodore 64 was in fact the first computer 
to have hardware sprites, and had iar superior graphics 
and sound than any other home computer at the time 
that it was launched. 

SPRITE MIGHT 

Sprites are the most versatile nbjei is to move, I hey don'l 
rub out any background and are generally a joy to use. 
For most programs the standard eight sprites .ire great 10 
use but for games you may want an assortment of aliens 
buzzing around, tilling the si. teen. ( Ihviously eight 
sprites will not fill the screen, It is for this reason that I 
have written this routine. 

The most versatile multiple routine for the Commodore I 

64. This program is not another "infamous t, I sprite ^^ 

extravaganza", See the "Commodore h4 programmers ref POKE 
guide". 




y locations like the video chip Ic 



32 SPRITE INFORMATION 

The program that is on this months disk, "32 SPRITES", 

will allow up to }2 sprites to be posilioned. expanded, 
coloured and pnoi iliscd ek . uinpieteh independently of 
each other. As an optional extra sunmol", you can even 
pill these into the tup arid I ml Mm boideis. When using 
more than eight sprites the prncram also cures the 
vertical wrapround thai is sometimes experienced in the 

Although each sprite is able to be controlled 
individually, you must remembei that there are in fact up 
to 4 strips of eight sprites. When using 16 sprites there is (See explanation heli 
one division verlii ally and It strips, with 24 sprites there 
are 2 divisions and 3 strips, finally, with 12 sprites there 
are 3 divisions and 4 strips. With the routine running at 
full capacity there art- s raster inlerrupis lining on. It is 
quite amazing how I he humble 64 i an ( ope. These 
divisions are invisible but woe betide any sprite thai 
decides to stray beyond Ihe divisions as the data lor the 
next lot will mingle with - iih-r-i s and pnidin e a nniireable 
quirk. There are two general rules lhai must be adhered 



COQ0-C7OO (431 S2-St) l l44: Are used by the routine. 
C400-C41 F (501 76-50207) Are ihe X positions for 

each sprite (0-31). 
C420-C43F (50208-502 39) Are ihe 'V positions for 

each sprite (0-311. 
C460-C47F (50240-50271 ) Are ihe colours for each 

sprite (0-31|. 
C4B0-C49F (50272-50335) Are the sprite poinlers for 

each sprite (0-311. 

(this decides what tne smites look like). 
C4A0-C48F (50336-50367) Are the volumes for the 

control register (0-31). 



CONTROL REGISTER 



to; 

1 . The divisions must not be less than 32 pixels ant 
lowesl 'V posilion lor any sprite must not be less it 
30, or the divisions will flicker. 

2. To position the sprites and i h.inge them you hav 



The control regisler is a mixture of MSB, SPRITE DATA 

PRIORITY, EXPANSION and MULTICOLOUR selection. 

Bit 7 in each register controls the MSB of each sprite, a 1 

will position the spiite into MSB area and a will place : 



iprite in X and Y direction. So a 6 1 will expand the 
in ihe X direction and a 32 will set the sprite in the 

ction. Bit 4 controls spi ile data priority and a 16 
>t the sprite behind the background. Bit 3 will set 



mode. Bits 2 to are unused. 
Bit values can be added so lhal 
if you wanted a sprite in the 
MSB, behind the background 



BORDER CONTROL 



'ON THE DISK 



THE TOP BORDER CAN BE TURNED ON (I.E 

rifRB n fe^MHO'iWra WITH a 

PRESS IpACE BE DISPLAVED UMD ER IT 

NUMBERS CAN BE DIRECTLY POKED INTO THE 

SC000 OR 49152 OHHARDS AREA 
EG. POKE 49152,90 <XPOS> 
EG. POKE 49174,90 <VPOS> 
WOULD PRINT A SPRITE 90 DONN AND 90 
ACROSS IF SC0A0-SC0A3 ARE SET 



To turn off the top and bottom 

borders you must change $C370 

{50083) to 1, to change the borders back to normal 

change the 1 to a 0. Also, to change the mess that 

appears .if the bottom, change bunion S3ITF (16383) to 

i). changing this to any olher number will make blank 

horizontal lines appear in the borders. 

THE TECHNICAL BITS 

To speed up the- sprite updjle ,ind animation, the roulin. 
at SC600 (50688) can be bypassed. What the routin 
actually does is to sort out the sprites positions and svv,i| 
large amounts of data into order, ftom the lowest to thi 



hlghesl sprite number. It has to do this so that the sprite 
display routine can print all the sprites. After the sort does 
its iol.i it stores the values for each sprite into 5C000- 
SCO.-Vi (441 52-49 .1131. Quite simple so far isn't It? Now 
for the hard part, ..Locations SCO0O-SCO9F (49152- 
49311) are an exact image of $C400-$C49F (50176- 
50.S.151 escept all ihe data lot each sprite is in order. The 
sort routine also updates the division, so SCtWt-SCU.-Vi 
I44312-.19.ri5i are (he raster positions for each division 
and must also be in order from the lowest to the highest. 
If a is in one of the division pointers then the division 

will be missed out completely and will go to the next 




re popular □ 



ROBERT TROUGHTON 



There isn't much dil'iererx <■: between sorting numerics and 
alpha-numerics, but I wanl to make this as easy to 
understand as I can, so il will be besl to slart with numl.iers! 
(which would you rather son into order... a long list of 
numbers, or a long list of words???). Later, if time permits, I 
will provide an article on sorting Alpha numerics. 

SORTING NUMBERS 

I will provide you with a few algorithms, and examples of 
what each one will do with a table of numbers, and will 
leave you to program Ihe routines into the C64 yourself - in 

Basic. Machine Code, or whatever language you prefer to 

Note that Left-Elements are all the numbers to the left of 
Ihe present- nu ml jer being checked, and Ihe Kighl-Eleinents 
are those to the right... 



THE INSERTION SORT 



1 1 Start with (he 2nd number, 

21 Compare it with all the Left-Elemenls, and plac 



50 24 36 62 12 48 9 80 71 
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50.24 

(50 is compared with 24. 24<50, so 24 in 1st position, (of 2) 

24.SO.36 

136 is compared with 24 and 50. 24<36<50 so 36 in 2nd 

position, (of 3) 
24.36.50.62 

(24<36<50<62 so 62 is kepi in 4th position, (of 4) 
24.36.50.62.12 

(1 2<24<36<SU<62 so 1 2 in I st position, (of 5} 
12.24.36.50.62.48 
(12<24<36<4B<50<62 so 48 in 4th position, ioib) 



6.48.51 



st position, (of 7} 



SHELL SORT 

Unlike the Bubble Sort, this one can move data by greater 
distances, and hence will probably lake less time] 
1 ) Choose an in1ei;er In di/lerm;'ne the number of 

positions between which i-oiv.p.iri-oii!. will be made. 

(eg. if you choose 6, on the 1 st pass, the 2nd number 

will be compared with the 8th). 

2) Start with the 1st number, ,niri compare it with the 
respective number (eg. 7th if a displacement of 6 was 
chosen). Make a swap if necessary. 

3) Move onto the new number, and continue until the 
end oflhe list is reached, 

41 Divide the ilKpl ir- 'i«nt hv '.'., keeping it .is an 

integer, -i" ' * ■ , i mi ili.m I ihen repeat from st,i|je 
2. When the displacemerit is less than 1 , the list will be 



BUBBLE SORT 

This sort is very commonly used, but like all sorts, it has it's 

I hi- ri.iiii' bubble del ■■.!.■■. from Ihe w.iv lli.il c,i. '■ inn ■:.;■■ 



1) Start with *e first 2 numbers, and compare them. 

2) If the 1 st number is greater than the second, a swap 
is necessary. Make .1 note somehow that a swap was 
performed. 

31 Move along the list one place tie. 2nd and 3rd 

numbers, 3rd and 4th etc.) until there are no more 

pairs to check. 
4) If a swap was performed at any point in the 'pass' 

then repeat from stage 1 . If no swap took place, the li; 

must be in the correct order. 

50.24 

(24<50 so swap performed). 

24 50,36 

(36<50 so swap performed). 

24 36 50.62 

(50<62 so no swap needed). 

24 36 50 62.12 

(12<62 so swap performed). 

24 36 50 12 62.48 

(48<62 so swap performed). 

24 36 50 12 48 62.9 

(9<62 so swap performed). 

24 36 50 12 48 9 62.80 

(62<80 so no swap), 

24 36 501248962 80.71 

(71<80 so swap iv tiled. Eidol'liit reached. 2nd pass necessary!. 

24.36 

(24<36 so no swap). 

24 36.50 

(36c50 so no swap). 

24 36 50.12 

(1 2<:50 so swap performed). 

... And so on until the list is sorter I (this will be known by 

the fact that no swaps will be performed in the 'final pass'). 



TAKING A DISPLACEMENT OF 6 

50.. 9 (9<50 so swap performed). 

...24 80... (24<80 so no swap needed). 

36 71 (36<71 so no swap needed). 

Listtsnow:- 

924 36 621248 50 8071 

DIVIDING DISPLACEMENT BY 2... INT<6/2) = 3 

9 62 ; no swap, 

..24 ..12 ;swap. 

36 48 ; no swap. 

62 50 ; swap. 

12 80... ; no swap. 

„ 48 71 ; no swap. 

91236 50 24 48 62 80 71 

Repeat for INTO/2) = 2. INT(J/LH = I, and then the list will 

be sorted because INT11/2) < 1. (The Cf>4 rounds DOWN 

(truncates)). 



QUICK SORT 

1) Start with 2 pointers (A,B) at either end of the list (or 
sublist, see later). 

2) Compare the 2 numbers defined by the pointers. If a 
swap is necessary, then do so and increment A by 1 . If 
no swap is necessary, der remi-nl B by ). 

3) Repeat stage 2 unlil the 2 pointers coincide. 

Note that at this point, all numbers in the Left-5ublist are less 
than the number at position of pointers, and all numbers in 

the Right- Sublist are greater. 

4) You may now ei I her -.art (villi sublist, or split the 
sublists into further smaller ^ublMs iwhich you may 
wish to do if von have a lot of (lata to be sorted). 

Note that quick-sorts are not meant for sorting a list into the 
correcl order, only lor providing shorter sub-lists, which can 
mi h be soiled (using one of the previously defined sublists) 
in a much shorter amount of time. 

I hope that this small article will shed some light onto the 
much hated subject of sorting numbers!™! will leave Sorting 
alphanumeric data till another time. 



-ADVENTURING 
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Adventure writer supremo JASON FINCH 
continues his tutorial for all you budding 
writers 

Initially I must give you a humungous apology for no) 
presenting you with the programs last month that I 
promised. This was due to a number of technical 
problems bul rest assured that they ate here this month 
for you - on the disk as AW-MODULES and AW- 
MODULES.MC. This month's instalment is quite short in 
comparison to the other ones lh.it I have given you. and 
that is because the topic we are discussing this month is 
"PARSING". That is, I am going to attempt to give you an 
in-depth look at how a parser, or command analysing 
system, worts so that in the tufute you will be ready to 
program your own, or accept the one that I shall be 
giving you at some later date. Suffice it to say that the 
subiei.t i.in bi'iuriii' \eiy complicated jiid I do mil wish 
to blind you with too many complex details all at once. 
Settle down with a cup of tea and this article in front of 
you and then continue. 

ONCE UPON A TIME... 

First of all let us assume that you have entered the 
following line and then we tan see how the parser and 
program may analyse it: 



6, IT 127. And some verbs: EAST 3, EXAMINE 7, OPEN 
6, PUT 16, TAKE 10. And to round things off, some 
adverbs, arijt:Uivc-s and/or linking words: ON 1, LARGE 
3, 

Hopefully you appreciate the fact that you must 
program the computer in such a way that it has an in- 
built databank of as many words as you think necessary. 
Do not try to cram the entirity of the Oxford dictionary 
into the memory as it just isn't essential. As a mattei of 
fact, about two hundred words is all you need. That may 
sound a lot at the moment but in a large adventure it is 
nothing, believe me! Now each word is given a number 



This is about the mini ujmpln Med four, of sen [em <■:■ ili.il 
you are likely to come across and before we start we 
need to assign a few words to the computer's vocabulary. 
Each one of these is then given a number. So we have 
nouns: CANDLE 1, CUPBOARD 4, SHELVES 12, TABLE 



command. 



which v 



,rd i 



the 



BREAKING IT DOWN 



e first thing to do with the sentence is to split 
mponent parts - the separate commands. For 



r (that 



3 for the bi 



program I hat breaks down your command and 
out how to react to what you have lyped) i 
recognise "." and "," and "1° and "and" and "thi 
being charactets or words that split up the 
naturally. The line would then break dow 
commands as shown below: 

1 . Open ihe cupboard (,) 

2. Examine the shelves (,) 

3. Take the large candle (andl 

4. Put it on the table (then) 

5. Co east 



ample, 
of the 

:hecks 



Each of thos 






commands is scanned for verbs, 
in that order. Any that ate found 
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1. OPEN the CUPBOARD - Verb: 8, Link: 0, Not 
Noun2: 

2. EXAMINE Ihe SHELVES - Verb: 7, Link: 0, Noui 
Noun2: 

3. TAKE the LARGE CANDLE - Verb: 10, Link: 3. ! 
1, Noun2:0 

4. PUT IT ON the TABLE - Verb: 16, Link: 1,Noun 
Noun2: 6 

5. Go EAST - Verb: 3, Link: 0, Nounl : 0, Noun2: 



that. The Information for the commands then becomes: 

1. V:B, L:0, Nl:4, N2:0 

2. V:7, L:0, N1:12, N2:0 

3. V:10, L:3, N1:l, N2:0 
4.V:16,L:1, Nlll, N2:6 
5. V:3, L:t), N1:0, N2:0 

These can either be done all in one go with the 
numbers stoted in a large table, or you can chop off each 

command in turn, analyse ii and tin": ii chop oil the ni.-\i 
bit from what is left. In my opinion the former is better 

and ahhoui;'- ■ ■•! n. nl.irK simple to program, 

I 1 -,. MilTii.'i ';■ j ■'■'■, !■ _ ■■!■■ '.■-. \ :-■ i ■.'.-■.'.■I l".-llli»l 

you choose you will need to Leep a record of how many 
commands are still la be processed. The next input 
prompt is displayed when this reaches zero. If using the 
first of the two above methods you must reserve a large 
enough area of memory lor the storage of information. A 
convenient maximum length of the input command line 
is no more than 256 characters. This gives a possible 1 28 
one letter commands which require four bytes each - a 
total of 51 2 bytes is required for the storage table. 



RESERVING MEMORY 

You will also need to reserve quite a large chunk of 

memory for the vocabulary of the computer. This is 
absolutely vital. Unless the computer knows what the 
pLiyei is saying, it can't do anything. The information for 
the words can be stored as set out below which allows 
for a maximum of 128 different verbs, 1 2B link words, 
and 128 nouns. For each one you should give as many 
synonyms as possible. For example - get, take and carry 
would alt lie ( hissed as the same verb. The words can be 

stored as ASCII values below 128. Ii ediately 

ing the word is then a value of ove' ' .'h wli i h 

represents, with 128 subtracted, the verb, I nk or noun 

number that pertains to that particular word Willi ou' 

previous example. !he word "table" whose noun number 

six would be stored as 84, 65, 66, 76, 69, 1 )4. 

Of course that method only refers to one method of 
jring the words and you can either chni..i- in i ■: mi.' 
mr own method and to write your own parser, whether 
be in BASIC or machine language, or to .■-<• mine 
replacing the vocabulary with whatever you wish. I 

doubi whether you will need a parser that .>c <(-:,', n- 

complex commands unless you want the ALL, EXCLPI, 



2b 



EVERYTHING options that allow for commands like 
"Take everything except the sword and put all on the 
table." You could, in that situation, have "everything" 
and "all" defined as nouns and "except" as a link word, 
so long as another link, such as an adjective, is not 
needed. 



A LESSON IN GRAMMAR 

Now to the different types of verb. Transitive verbs 
require an object or noun. For example: CATCH the 
ball, OPEN the door. KILL the guard, are all examples of 
transitive verbs in use. LOOK, HELP, EAST are all non- 
transitfve, It is usually best to group the transitive verbs 
Together because then you only need a simple check in 
the program to see whether a noun should have been 
typed. For example: IF V<10 THEN,... Various other 
chinks need to he considered when writing the parser - 
what happens, for instance, if the command "Light the 
light" is given. As it stands, the parser would simply 
assign the second "light" as a verb because they are 
checked first You musl ensure that if a verb is read and 
one has already been assigned, then check the nouns 
instead. In this way, ihe number for the verb "light" 
would be stored and when "light" was encountered 
again the computer would have to think 'well I've 
already had a verb so perhaps it is a noun'. Of course 
your humble 64 hasn't got a brain as such (ahh!) so you 
have to program it to respond in such a manner. And 
don'l forget you must assign ihe noun as Noun2 if one 
has already been assigned. If three or more are found 
then simply ignore all but the first two - why not? 

There may be some nonsense inputs like "Get drop 
the lamp" that some strange person may enter to see 
what happens. Using the previous method, unless 
"drop" was defined as a noun, although I can't see why 
you should ever do that, the parser would ignore it and 
the resultant command would be interpreted as "get 
lamp". Although my parser would allow this, you could 
include a check so thai if two verbs were encountered 
id the second wasn't a noun either, then respond with 



i "Sorry, what are you goinj 



about;" 



few words have just touched upon the concept 
of parsing and hopefully you can see how complex your 
parser could become. However, you can keep it to a 
bare minimum and just let it accept the verb-noun 
input. This Is quite easy in BASIC - just write a routine , 

to split the input into M-paraio words and then check to 
see what is what. Also on this issue's disk Is a BASIC i 

parser that does that. You can expand on it if you like - I 
have kept it very simple, nowhere near as complex as 
■he (aster machine code one. 

hat concludes this month's dose of information, lust 
■errember that the computer needs a vocab list and 
needs to split up the command that the player enters in 
oia>r that the adventure program may be able to 
iivi -In- i . in i nun i'i;- i" : " '■" ,, i- I'lii-. ■-•-ii-.ihli-. I lis ,s 
undoubtedly the most complex and possibly interesting 
parts of the adventure programming and so if you 
dei de to embark on a parser, I wish you the best of 
lui < Next time we meet will be March, so until then - 
plf.isant parsing!!! 
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Signs, complements and confusion make up this month's tutorial. 
IOHN SIMPSON 



il is possible to represent the Clearly, binary addition of signed numbers does not 
. Almost appear to work. The computer must not just represent 



immcdidk'ly we will observe th.it there a 
obstacles to overcome here. The Bra being that we can 
only represent positive numbers, and the second that the 
magnitude of the number is limited to 255. 



SIGNED BINARY 




We use the leftmost bit ul 
to indicate whether the 
negative. If the bit is c 
positive, and if the bit is 
negative. 


the binary number, ere bit 
numbrr • e iher positive I 
ear, ie then the number 
set ie ' Iht-n |he r.ji-ber 


eg. 00000001 = + 
10000001 = - 

00001111 = + 
10001111 = - 

01111111 = + 


1 

15 
15 
127 





lution to this probli 
implement". Howe 
led, "one's complement". 

ONE'S COMPLEMENT 



represented in their 'true' binary form, but negative 
numbers are obtained by ti.iristorriini; '.'very bil into its 
opposite: 



example: 

■ 0000001 
-11111101 -Ol 

t we shall add "- 



+ (+6) +00000110 
=f+2)(1) 00000001 



We can see 
the byte to 1 
from -127, t< 

If We require larger numbers, then we niu-l add mure 
bits. For example, if we use two bytes, a sixteen bil 
word, we increase the magnitude to 64k unsigned, or - 
32k to +32k signed (remember from the earlier 
discussion a k, or kilobyte = 1,024). If this magnitude is 
still too small for the requirement, then we can use ihree where (i I indicates a carry. Of o 
bytes or more as necessary. should have been "+2", or "00000 

If we wish to use large floating point numbers then we Another test: 
must use a correspond ingk large .imount of bytes. This 
is why Basic, and other languages only provide limitei 

JUST FOR CONFUSION 

Let us perform an addition in signed binary by addin 



+ (-2) 
= I-5H1) 



00000001 

It is incorrect, it 



(+2) 10001100, c 
Obviously the decimal re! 



TWO'S COMPLEMENT 

In two's complemenl positive numbers ; 
reprise nti-d ,--; usual in signed binary, the same 
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repreM-nMliun ul" nui^tlti 
each bit, as we did in 
further add one to tr 

complement. 

eg. +J representi-d in 


ver the difference in the 
ve numbers is first to complement 
one's complement, but then we 
tnsform the number into two's 

signed binary 00000011 


numbers are to large, Essenlially it is ; 
from bit 6 to bit 7 (the sign bit). 

THE CARRY 

(12B) 10000000 

+ 1129) + 10000001 


n internal carry 


- 3 (+3's one's cor 
add 1 for two's c 


iplement) 
omplemen. 


11H11 00 
00000001 


=(257)(1S 00000001 





=(+B) 00001000 

is correct. Remember the lehmosl 

v for subtraction (which, of cours 
an). 

(+3) 00000011 



s us the 
lone by 



where (1 ) indicates a carry o. >. . 

The result of llii- demonstration requires another, extra, 
bit, the eighth bit. Internally the microprocessor 
iCd-l/l 28i UM". millers which are only eight bits wide (a 
byte), so when storing a result only bits 0to7 are 
preserved. The carry, therefore, will requir 
attention, and is detected using specia 1 ! --* 
Processing the carry means either storing it I 
usually in another byte (the hi byte), i 
completely, or deciding, if the largest authori. 
11111111 (255), that it is an error. 



THE OVERFLOW 

samples of Overflow situations during signed 



=(+2) 111111 
: us identify the 



Therefore the two's compleme 
110 represents "- 



=(-127) 1000001)1 



An internal carry has occurred from bit 6 to 7 - this is an 
overflow, and, "by accident", the result is now negative. 
This situation must be detected so that it may be 
corrected. 



(+41 00000100 



= (+1)(1) 00000001 ID represents the carry. 

We i u!l :^riljru lilt- I. Jl.'i I ■" : I ..:'.i; •■.:■•: i',11 I hi-' I -- 1. 1 i i • 

correct. In two's complement it is possible to add or 
subtract signed numbers regardless of the sign using the 
usual rules of binary addition, the result always comes 
out correct, including the sign. 

representation to use for microprocessors. On more 
complex processors the one's complement may be used 
but it docs ri.ii li in.' special circuitry to "correct the result", 
but this does s i y. n i i i t ,-inllv speed up tin-: processing time. 

The following camples will ^erve to demons-lr^te (!>■ 
rules of two's complement, however, here "C will 
denote a possible carry [or borrow). This can be 
considered as bit eight of the result. "V" will be used to 
denote a two's i urnulemenl overflow. This is where ihe 
sign of the result is 'accidently' changed because the 



Here an overflow carry has oi.i.urrerl Imm bit 6 to 7, and 
a carry from bit 7 into "C" (the carry). The "C" should be 
igrmri'il. arid because the internal carry from bit 6 to 7 
did not change the sign bit, then the result is correct. 



=1+127)0)01111 



In Ihis situation there has been an internal carry from bit 
6 to 7, but the result is incurred because bit 7 has been 
( h.mgi'd. .in overflow !«> been indicated. 

The carry and the overflow indicators are called 
"ll.igs", , : ind ,i register know" c.s the SlJiu^ KegiMur is put 
aside for the use of these, and other "flags". Each bit of 
the register denoting a particular flag. 

When there is a carry from bit 6 to 7 the "V" fag will 



become set, and the "C" flag when ihere is a catty from 
bit 7. Overflow indiraies thai ihe result of the addition of 
signet! numbers requires more bits than are available. 
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negative - negative 
(with overflow) 
10000001 (-127) 

ni 000010 (-6?) 



MORE EXAMPLES 


= 11111010 (-6) =01000011 (-67) 






V=0:C=1 V=1:C=1 


positive - positive 


positive- positive 


(distegatd) 




with overflow 


(CORRECT) (ERROR) - An overflow 
has occurred. 


00000110 (+6) 


01111111 (+127) 




+00001000 (+8) 


+ ui!INXK!i)l (+1) 


by adding two large negative numbets together The 

result would In- -IH4. which is tun I.itllc !<> ht into eiiilil 


=00001110 (+14) 


= 10000000 (-128) 


bits. 


V=0:C=0 


V=1:C=0 






Invalid an overflow has 


BACK TO MAGNITUDE 




occurred. 




(CORRECT) 


(ERROR) 


If we want to represent larger numbets we will need to 
use several bytes, and in order to efficiently perform 

arilhmetic operations it is good practice to fix the- number 


positive - negative 


positive - negative 


of bytes we intend to use. This is called a fixed 


(result positive) 


(resull negative) 


1 have, so lar restricted the Lidding of numbers to one 






00000100 (+4) 


00000010 (+2) 


byte because the 64/1 28 operates primarily on eight bits 


+ 11111110 1-2) 


+ 11111100 (-4) 


at a time. Because this restricts us to a range of -127 to 






+ 127, then clearly this is insufficient fot most 


=00000010 (+2) 


= 11111110 (-2) 


applications. 


V=0:C=1 


V=0:C=0 


New month we will continue with looking at how we 


(disregard) 




can use MULTIPLE PRECISION to increase our range. 


(CORRECT! 


(CORRECT) 


Until then, keep experimenting. 



DESIGNING A ROLE 
PLAYING GAME 



Fight the good fight by GORDON HAMLETT. 



Last month, I examined various ways, or rlesii-ninu voui ground it.,! I IMA), ill the wav to the advanced system of a 

characters tor KPCJs. Although you can have a lol of fun game like DUNGEONS ANE) DRAGONS. It is this last 

with Ibis aspect of your program, once the character has system that we will be concentrating on. When you 

been designed, this part of the program is largely realise what can be involved, then you can make the 



The fi 



INTO COMBAT 

There is one element of RPGs though on which the 
quality of of your game will stand or fall; COMBAT. Any 
adventurer worth his salt knows that the only way to 
fame and glory, not to mention the treasure, is to start oil" 
killing a lew GOBLINS and then working your way up to 
DRAGONS and DEMONS. If combat is not for you, then 
stick to traditional adventures. 

The scope for your own combat system is enormous. 
You can include as much detail as you want ranging from The 

the fairly simplistic (BARD'S TALE), through the middle the firs 



appmpi at.- fli-dsiu.i as In what In leave out. 

DANGEROUS ENCOUNTERS 



tthin 






V.-hrllllT 



battle. The answer is probably yes 
al the lower end of the market but as games become 
more sophisticated, you may wish to introduce the 
■lemenl of running away, talking to, trading with or 
simply bribing whoever is standing in front of you. 
NeverthHess. for the purposes of this article, we shall 
issume that the encounter is a hostile one. 

be made is to work oi 



blo\ 



f Ihe battle 



the 



of a 



'ell 



S T R AT E G Y- 



planned ambush, then ihere is no problem, you give the 
ambushing side one free hit ad round and then lake it 
from there. 

Otherwise, vou have- lu (L-rrck- on 1 1 r ■-. L sirike (in either 
a team or individual basis. Factors affecting this might 
include a character's dexterity or a special item being 
used such as boots of speed. Traditionally. ELVES nave 
quicker reactions than HUMANS etc. and so are less 
likely to be surprised. II should be per feci I y possible lur 
two opponents to strike .51 exactly the same time and for 
the results of both their blows to be iaken into account. 

GET IN FIRST 

The concept of first strike really is important. For 
example, in SSI's DUNGEONS AND DRAGONS series, a 
magic user cannot cast a spell that particular round If he 
has been hit so if you can guarantee to attack first and 
loss a I i retail! I into the jieiei. then ol'n iously you are at a 
huge advantage. 

If you have ever played CHESS, you will soon realise 
that it doesn't matter if you have some powerful pieces if 
the* arc " no position to press home their attack. The 
ability to n an:* .■■■< >n order to gain a tactical advantage 
adds considerably in any combat system, 

/Vim inn, di" 'he three most popular commercially 
available games. In SARD'S TALE, you cannot move at 
all. I he party is Mm led to advancing as a group. In 
ULTIMA, a separate rombat screen is displayed and 
characters ran eifer move or attack when it is their turn. 
In DUNGEONS AND DRAGONS, each character has a 
movement allow,! nee whit h i- determined ta. llic wigfo 
being carried and the character's strength. The player can 
move round the battlefield and attack as he sees I : 

Obviously, tin? la si system oilers huge ■■■■■. 
variety and scope for the player. A strong fighter can 
move over to protect an injured friend or a weak magir 
user. You can also make good use of the terrain us ng a 
wall or tree to protect your back. You can also make 
intelligent decisions as to where to concentrate your 
attacks better (eg; attempt to reach Ihe t ■< "-. ^|» ' 
casters as quickly as possible). 

BATTLE EQUIPMENT 

Once you have an opponent in front, the actual process 
of fighting one another can begin. There will be a 
pen cnlage chance of successfully scon no. a telling Nort- 
on your adversary. This will normally be calculated as a 
basic chance, modified by the armour your opponent is 
wearing [armour here is a general term; it is more than 
likely to be a thick, leathery hide on a troll or the scaly 
skin of a dragon. I This chance to hit might be further 
modified by special items or characteristics. For example, 
a magic sword should (unless it is cursed) give a better 
chance of hitting than a normal model (it will cause more 
damage too) Similarly, a very strong character might be 
able to exert a blow of such ferocity that it breaks 
through the enemy's shield or whatever. Remember 
though thai Ihe opposite should apply for very weak 
characters. 

You do not have to be standing in front of an opponent 
in order to be able to hit him. Long weapons such as 
spears mighi enable you to attack over the head of a 



colleague. Then there are all the various missiles; arrows, 
crossixiw- bolts, huiiklers, slings, daggers, hand axes and 
so on. With ihese weapons, you will need to determine a 
maximum range together and then work out if an 
opponent is in line of sight on the battlefield. 

Some weapons, eg flaming oil and magic spells such 
as fireballs might affect an area rather than an individual. 
Remember that everybody within that area is 'attacked', 
even if it includes a member of your own party. 

DAMAGE POINTS 

A successful hit will result in your opponent suffering 
damage. This is invariably measured in hit points. When 
someone's hit points are reduced to 2ero, then that 
character is deemed lo have died. Damage is usually a 
r.indi .in figure within a range specified lor each weapon. 
Thus a long sword might cause I -10 points of damage 
whereas a dagger might only cause 1-4. Again, these 
figure ■ led by magkal weapons so r : ■ a t a 

'+1' long sworn wou if cause 2-11 damage points (1-10 
+11. 

Again, damage i in be affected by strength. Some 
damage depends as well on the skill of the person 
inflict "g it I- - .,s...> ly applies to spells. A magic bolt 
might cai.se J points of damage per level of spell 
caster. This means that a novice starting out on an 
adventure would only cause 1-3 points. By the time he 
was a twelfth level magician though, the same spell 
would cause 1 2-36 points of damage. 



MORE COMPLEX ROUTINES 

I s more or less the main part of a combat system 
lj ried What is written above implies equally to the 
is(cr« atta< king your party. The battle is divided up 



lunds 



vlth c 



consisting oi every person involved in the battle having 
one chance to do something. First strike is then 
determined all over again as the nest round begins and 

.-. i,n uul l r-e 'altle is won, hopefully by your side. 

I nere are a couple of odds and ends to be cleared up 

taeii ire moving on. Should any person turn and run away 
whilst the battle is in progress, any opponent that he 
passes directly in front of gets the chance of a nee swipe. 
Additionally, this extra hit is aimed at the back. As well 
as being considerably easier to hit, all armour class 
bonuses due to shields and dexterity etc are no longer 

INVISIBILITY 

Invisible creatures give themselves away as soon as they 
attack. You might decide that they are still difficult to hit, 
but at least you know where they are. CLERICS can 
usually call on their various gods to help them if they are 
in combat against evil spirits, usually called the urtdead; 
skeletons, vampires and so on. Allow one attempt per 
combat per cleric to see if you can dispel these evil 
spirits. Remember, a battle does not consist solely of 
moving and hitting. Characters might wish to do 
something else; shoul a word of surrender, quaff a potion, 
change weapons, use a magical item and so on. 
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AERIAL COMBAT 

Finally, aerial combat As it is almosl impossible to depict 
a 3D battle on a 2D monitor, my suggestion is, forget it. 
Remember .it all limes, you are the ultimate creator as far 
as these games go. If something doesn't fit into your story, 
then leave it out and use the idea elsewhere. You do not 
have to explain your theories to anybody else or argue 
with someone who wants to use a PEGASUS instead of a 
horse. You are the boss. 



GAINING IDEAS 

If you are interested in looking into the ideas behind 

combat or any other s\^tt-nih more deeply, then I would 
strongly recommend that you take a look at the 
DUNCEONMASTER'S GUIDE AND PLAYER'S manual, 
both published by TSR. Although ihey refer exclusively to 
the ADVANCED DUNGEONS AND DRAGONS 
SYSTEM, they are well thought out and go into much 
greater detail than I can. You won't agree with everything 
that ihey include by a long stretch but you will get a lot 
of ideas. Remember though, you ate Irving to devise your 
own original system, not copy somebody else's. 

Once the battle is won, it is time to give out the 
rewards. Experience points and treasure are what every 
adventurer strives for and if there is one area likely to 
unbalance your game quicker than anything else, it is the 



alii 



noflc 



KEEPING INTEREST ALIVE 

To start with, you have got to keep the player interested. 
There is no point having a vicious and dangerous battle 
against a couple of minor demons If the only reward is a 
few experience points and a couple of gold pieces each. 
The players are not going to come back for more. But, 
equally importantly, do not fall into the temptation of 
giving too much away too quickly. If you acquire a +6 
sword of giant slaying .ifler your first £ 
parly of GOBLINS, what are you going t 
when they defeat the aforementioned giant? 






. the 



e of the treasure. It is alright for 
e horde of gold because 



DRAGONS t 

that is what dragons do. But if a GOBLIf 

+ 1 suit of armour, the chances are that he is going to 

wear it, not hide it away in a locked chest. A creature of 

very low intelligence such as a giant worm that wanders 

around dungeons socking up debris is going to be full of 

precisely that, debris. There might be the odd worthwhile 

article somewhere in the slime of its gizzard but then 

again, there might not be. 

If you decide that defeating a group of TROLLS is 
going to produce treasure worth 500 gold pieces, it 
certainly won't be in the form of a single piece of 
jewellery. Do you carry all your worldly goods around 
when you go out shopping? Of course you don't so why 
should you expect a raiding party of KOBOLDS to do 



likewise. Nov,, it you catch them in their lair, then that is 
a different matter. But now, the treasure is likely to be 
hidden, or trapped, or both. Intelligent monsters will 
know what their stuff is worth and make best possible use 



IN CONCLUSION 

The last thing I wish to say about combat is to 
its frequency. You will have various planned ei 
inside your sel scenarios; < astles. dungeons or whatever. 
It should be possible to ensure that the player tackles the 
scenarios in the right order so that the strength of the 
monsters will be about what you want it to be. But there 
are also random encounters as the party travels about 
and there is nothing worse than a group of monsters that 
is so strong that it wipes out your party at a stroke. 
Similarly, if you h.ivn a strong parly, then repeated battles 
against monsters thai you can kill without thinking, 
quickly leads to boredom. Irkully, a group of monsters 
should be about equal or up to ten per cent stronger than 
your party so that there is a real sense of achievement 
when you defeat them. Look for variety. Always prefer a 
lew interesting scenarios to a lot of routine ones. If you 
have a sophisticated rornbal system, then fine, make full 
use of it. if it is more simplistk . look towards other areas 
of the game to keep your players coming back. 
Next month I will look at that interesting aspect, MACfC. 
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FURTHER ADVENTURES IN 

v 



So far in this series we have covered a lot of the basic rules argc is always at least 1 . In our examples argc was 3, so 

and procedures that go into making 'C the excellent argvlll is the first real argument, and the last is argvlargc-1] 

language thai it is. These last two instalments should finish (in the examples argv|2l). Should argc equal 1, then there 

by giving you enough knowledge to go out and write some are no command line an;umeNs .iiie.r ihe program name, 

really good software. Here isasnull program to illustrate further: 



COMMANDLINE ARGUMENTS 

It would be iise.iul n in: were able lo pass some p.immeiers 
to the program itself from [he operating system. For 
Instance if we had a program culled COPY, which copied 
one file into another file, or some other device, such as a 
printer, then we could enter a command line argument 

COPYFILE-1 FILE-2, or COPYFILE-1 PRINTER 

This exjrnple illiNutr- ■: sin: in 1 .ifjplii ,ihin <>i a In hnique 
whereby a much larger number of additional commands 
could be added In ihe nperaiin;.. sysiem structure. 

Well C does provide a sophisticaled method oi dealing 
with such a situation by means of two arguments which 
can be passed to function mainO at 



By conve.nl n >n 1 1 n ■ lwn ■ iivmrienls art- railed 'AKGC. .ind 
'ARGV. Here ARCC is an integer which will contain the 
number of command I in ej arguments, and ARCV is a 
pointer to an array of character strings which are the 
arguments in question. 

Here are some examples of values held by argc and argv: 

COMMAND LINE - "lest prog 1" 



/* Command line 
#include <sldio.h 
main(argc,arg«) 
intargc; 
char"argv[|; 



s*J 



argvlOl ■ 
argv[1] ■ 
argv[2] 



argvIO] 

argvlll 
argv|2| 



printfC'The value held in argc is %d\n",argc); 
while! — argoO) 
printfT%s%c'', ,, ++argv,(argc>1 )?' 'An'); 



Ihe lirsl line i.n i lie pfourom simply prints .ml Ihe value held 
in argc. Note, Wo, the method of declaring an array which 
is not dimensioned " [I ", this means that the array in ol 
undetermined length. 

The while loop is controlled by the statement: 
while! — argoO) 
This decrements argc, and as long as it is greater than zero 
it will execute the body of the loop. This means that when 
argc: is zero, the name of the program, il will terminate 
because there are no more arguments to print. 

Let's break down the new line: 
prinlf["%s7 c",*++arEV,(argo1)i":'\n'); 
*++argv, - deliver Ihe conlenls of the address pointed to 
by argv+i and incremenl argv to same. The reason for 
prefix increment is we are not interested in printing the 
program name, 

UrgoD?' 'An'); - This ilLsluies Ihe subtle use of the 
operators ( f: ), they replace the if.. .else. In other words:- if 
argc is greater than 1 then a space ' ' is printed, and if not 
(else) then a newline 'V is printed. 

The effect is to print out the arguments of the command 
line, with spaces separating each argument and the whole 
ending with ,i new line. 



STRUCTURES 

a group of data types combined a 
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Item. This allows the data to be grouped for easier 
manipulation under a single name. 

Probably the most traditional example I could use is a 
'payroll' record. We i. an lit? together .1 set ol attributes. su< h 
as: name, address, insurance number, salary, etc and tag 
this to an 'employee'. Some of these attributes could, in 
turn, be slnictures themselves. ,i name or ,111 address, for 
evample, consists of several components. 

Complicated data can be more effii ie'H'v o-^onized l' A 
using a structure, particularly in large prog'ams. because 
instead of using separate entities a group of related 
variables can be treated as a single unit 



■nl It i win:; ii'- definki'iri iviih ,1 lisi it; initialisers: 
struct date person = 1 11,12,1938, "Dec" }; 
When we wish to refer to a member of a | 

structure we um- a construction of the expressi 



STRUCTURE-NAME.MEMBER 

Here the structure member operator ". 
structure name and the member name 
from structure dee of the type date, a lin 



BASICS of STRUCTURE 



' of the year and nan 
variables, and they c. 



Let's start by using an example. A 
parts', day/month/year - perhaps d 
of the month. This will give us tiv 
all be grouped into a single structu 

struct date { 



]; 



The declaration of a structure uses the keyword, struct. An 
optional noine, "r \.y,\ as il is somc-innes called. may follow, 
as within this example where I used the tag name, date. 
The variables mentioned in the structure are usually called 
structure members. 

The righl brace which terminated the list of the members 
of the strut mrr m,i\ he IoIIowkI hv ,i list of variables: 
struct 1 } x,y,i; 



leap, year = dee.year %4 = 
&&dee.year%100!=0 
I I dee.year %400 = 0; 

or to check the month name: 

if ( stremp ( dee. year. day, "Dec" I == ) ... 

We can also nest structures, and the payroll i 
looked at earlier might actually look like (his; 



.1 employee ■! 

nelna 









char post_ctxle|B]; 
long ni_number; 
double salary; 

Struct date bird' d.llc: 



Lt date hi 



_date; 






ct employee emp; 



is the s« 



in the 



x,yx 



e that e 



declar 



, be 



variables of the named type and will allocate storage space 
for them. 

A structure declaration which is not followed by a list of 
variable^ does m it a- Incite storage space, out will desi ilhe 
the shape, or template, of the structure which can then be 
tilled later. 

We could, after the terminating right brace, and in front of 
the semicolon, initialize the slrui ture by defining a variable 
here, such as c which is a structure of type date. By 
omitting the variable at this point then we can define il later 



emp . birth date.monlh 

will refer to the month of birth, as: 

emp.hire_date.yeAr 
will refer id ihn war the t'mnlnynH was hired. Mote that the 
structure member "." a sin cute' left to right 

Older versions of C did not allow for the transfer of daw 
from one structure to another. However now if it was 
necessary to transier dam between two variables of the 
same structure type, Sriy ,i and h, ihen the Irausrer is simply 
h=a: We can also pass structure names to functions: 
record (dale) 



.vith.ilirw 



ich as: 



We could also, if we wished, dt 
example: 

struct date c,d,e; 

which means that c,d,and e are al 
type, date. 

struct date dee; 
will define a variable dee which i: 



variables oi the 



FUNCTIONS AND STRUCTURES 

separately, or pass a pointer to the whole thing. The first 
alternative can be shown in the following example: 

First we need lo demonstrate ;i sm.ili lunclion which 
will set the day of the year from the month and the day. 
This example presumes the tables required have been 
of type, date. de> lared and ■"ieale.ed elsewhere. 
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day_of_yea r(year,month , d ay) 
int year, month, bay; 
I 
int i, leap; 

leap = year %4 =0 

&&year%100!=0 

llyear%400 = 0; 

for li=1 ; i<month; i++) | 

day +=day_tab[leapl[i]; 



I 
returnldayi: 



Now we can pass individual members: 

dee.yeardate 
day_of_yea r(dee .yea r,dee.month,dee.day); 

and the other alternative to pass a pointer, using our sub- 
structure hirerlate .ibnvti, ,n«l rewritten day_of_year, we can 

hire date.yearday = day_of_year(&hire_date); 
The function day_of_year now requires modification 
because its argument is now a poinler from hiredate rather 
than a list of variables as was the original function earlier. 

/* set day of year from month and day */ 

day_of_year(ptrdate) 

struct date "ptrdate 

int i,day,leap; 

day = ptrc)ate->day; 

leap = ptrdate->year%4 == &S. 

ptrdate->year%100!=0ll 

ptrdate->year%400 == 0; 
forti=l; i<ptrdate->month; i++) I 
rJay+=dayjablleapJIT]; 



i Lit: r record lists|l=| 
"lenni Phillips".6,"Jul",l 970, 
"Malcolm Mclean",23,"Dec",1 956, 
"John Oldbuddy",11,"Dec",l82r, 
■ , MaryLamb",31,"Feb",ie72, 
"lack Homer"! 2,"Mar",1 761 



c=x=1; 

for (;;) f 
printfC Which record do you wish to view?\n") 
printf ( "(Type Q to quit ) " ); 
x=getcharf); 
if <x = 'Q') break; 
x=x-'0'; 

H6o=5) { 
printft"'** ERROR. VALUE INCORRECTVl"); 
continue; 

I 

p r i n if ( '■ "A *\ n " . I i sis I x I . name); 
pri ntfl "%d \ n " , I i sts [x] .day) ; 
pri ntf ( "%s\ n ", I i sts |x| . month ) ; 
pri ntll "%ri \ n " , I i sts [x] .yea rl ; 
I 



I 



rnidjyi; 



Let us look at Ihis in detail. The declaration 
struct dale ■ptrdate; 

tells us that we have a si nidi ire type riiuneti (late, and that a 
pointer " "ptrdate * points to it. The operator " -> " refers to 
a particular member of the structure. Therefore ptrdate- 
>year is pointing tn the \e."H' v.niarile nl ;he ■.Inn lure djie. 
This could also have been written as: ('ptrdate).year 



ARRAYS OF STRUCTURES 



an be seen, we have created a character array to 
din the names of the persons to be held in the record, 
ell as their date of birth. We have declared an array of 

struct record lists!] 

We men have the lists oi iijmes. day. month, year. The 
older nl the diu eleuieriis is impurunl, .1 niusl match the 
structure member lh.il it corresponds with. The number of 
■irr.ty elements is jutomati' .illv i ,i leu I. net I hum this list. 

The function main!) allows the user to access the array 
■mil prim the lekv.int ii,n.-i niei.iined min the screen. The 
melhod ol accessing each member of the list is shown 
within the printfO output statements. Namely: 

strudu re-name[element n umber] .structu re-membe r; 
It is also possible, and practical, to °r 
even arrays of structures, For example: 

struct address! 



It is also valid to have arrays of slructures, which a 
extremely useful for handling blocks oi related data. 
Let's examine a small program: 
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struct address here: 
int workno; 

I 

detalls[3] = | 

"M. Thatch "."Janitor", "06/1 0/23","1 Down 
5t","London",007.52000, 

"H. Husbnd","Sampler","07/08/21 ","10 Down 
sr,"London',008,28000, 

™A.Worker","Nurse",~26/10/6B"/T0New 
Street", "Bedford", 009,8500, 
I; 
V Resl of Program.... */ 



ig the information contained in the records would 
lie similar to that outlined earlier demonslraling arrays of 
structures. You must consider the nature of "structured" 
structures. If you consider the structure array as a series of 
hn'.o- 'pigeon hilled. then urn mih.l. . n-.i.i'lv, j.<i In I lii ■ 
correct bo*, or array element, where inside is contained the 
data items. This consists of (in the above example) 
structure detail as well as two other boxes, namely, 
structure address, and structure employee. These two 
further boxes can ihen be opened to access the data which 
they will contain. 

As you can see, structures are a most powerful 
programming tool which C capitalizes upon. Memory 
dependent, a vast network of interlinked and nested arrays 
and structures can be formed to give fast and accurate data 
retrieval. 



UNIONS 

Objects of different types and sizes may be held, at 
different times, within a variable called a UNION. These 

provide uk with a way in which we are able to manipulate 
different kinds of data wiihin a single storage area. 

Suppose that some constants may be [NT'S, FLOAT'S or 
even character pointers. The value of a particular constant 
must be stored wiihin a variable of the correct type, yet it is 
more convenient for the nwii.iUiTiii-ii: in tables it the value 
occupies the same amount of storage and in the same place 
regardless of its type. Here lies the purpose of the UNION. 
It will provide a -ingle variable which in able to hold any 
one of several types. The syntax is based upon ! 



/aluel 



u n i on-po i n I er- >u n ion- mem ber 

Let us examine an illustration. We have a variable 
UNIONTYPE which we are going to use to keep track of 
the current type we have stored in UNIONVAL (It is up to 
ihe programmer to keep track of the current type in the 



if iuniorilype==int) 

printf("%d\n", unionval.intvall 
else if (uniontype == float) 

ptintfC%f\n", unionval.floval); 
else if (uniontype == string) 

printf("%s\n", unionval.ptrval) 



float floval; 
char *ptrval; 



■M UNIONVALW, 



int uniontype; 

float floval; 
char 'ptrval; 

1 symboltablNUMSYM]; 

here the variable INTVAL is referred to by: 

sym bolta b ( i] . u n i o nva I. i nival 
and the firsi character of the string PTRVAL would be: 

*symboltab|i|. unionval.ptrval 

TO CONCLUDE 



Next issue we shall be examining INPUT and OUTPUT, 
imiiurivdi; These facilities are not part of the C language, and I have 

not emphasized them in my presentation of C thus far. 
In this example we have a variable, UNIONVAL, which However, real programs do interact with their environment 
will hold the largest ol the three types. Anyone of these in more complicated ways than shown so far, therefore, 
types can be assigned It) UNIONVAL and can then be used next issue we shall be looking at the "standard I/O library", 
wiihin expressions (that is, so long as this is consistent - a set of functions designed to provide a standard 
namely that the type retrieved is the type most recently input/output system for C programs, 
stored). Until then, bye... 
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HELP LINE 



JASON FINCH begins his second series of hints and tips for all those 
Adventure buffs 



Hello, good evening, and welcome lo another edition 
of Adventure Helpline. We are now in stage (wo of the 
proceedings, having finished dealing with TONV a key 
ROME'S epic adventure KRON last month. This month 



irks the da> 



I Of 3 



- the 



t to 



i in brackets are only available w 
ire satisfied, such as whether or n 
door, whilst all the other exits 
available. You may find that yel more are a 
they will be discussed at a later date. So wit 
fuss, let us get on with the proceedings... 




successfully inform you of how to complete another 
excellent adventure published by CDU in June of last 
year. The adventure this lime round, then, is THE 
ASTRODLJS AFFAIR written by MARK TURNER. Vou will 
have had plenty of time to play about with it and a few 
of you may have given up if you couldn't solve the 
problems. For those people I shall, hopefully, inject new 
life into the adventure. For others of you who are still 
trying to find the missing link in your adventuring, I 
shall give what advice I can although I won't fully reveal 
the step-by-step guide to completing The ASTRODUS 
AFFAIR for a couple of months yet. 



LET US BEGIN 

I approached KRON by first giving a general goide and 

then a much more derailed one. This lime around I shall You're in a damaged, dank room, 

firstly set out the room descriptions and give each one a and the exit south, smeared 

number that I shall then refer to for the rest of the lime dishevelled generator sits in the ci 

that this adventure is covered. There are twenty-four EXIT: SOUTH 2 

locations altogether in the adventure and I shall cover 

fifteen this month, and then the remaining ones together 

with a bit of vocabulary next month. In the first two 2 

articles there won't really be a lot of information to help 

you solve the thing - it will just lay down the foundations This is the far end of a grey corridor leading off to the 

and inform you of (he exits that are .iv.iil.ible to you. 
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iorlh and a murky stairwell 



south. A ilin 

downwards. 

EXITS: NORTH 1, SOUTH 3, DOWN 17 (next month!) 



10 



The corridor continues along here from north to south, 
its metallic floor inclining. 
EXITS: NORTH 2, (SOUTH 4) 



S the far end of the 



rridor. A large door 



You're standing on a tiny platform within the 
slabalisation chamber, projecting from the wall over a 
large drop to the floor below. The cylindrical metallic 
chamber has only two exits; the one currently to your 
west, and another a I floor level. 
EXITS: WEST 4, (DOWN 6) 



11 



This is the crew's area, with numerous doors leading to 
the tiny, funcliunal rooms, all of which have been 
ruthlessly pillaged. EXITS lead north and east. 
EXITS: NORTH 7, EAST 12 



leads east, a room lies to the south, and the corridor 
continues north. The door is open/closed. 
EXITS: NORTH 3, SOUTH 10, (EAST 5) 



12 



You're at a spacious lounge. Extremely comfortable 
glomuchairs fill the room, and doors lead off to the 
north, west and south. A small stiver disc is set into the 

EXITS; NORTH 8, SOUTH 16, WEST 11 



13 



Although dark and gloomy, you c 
iimIiiu's of Ihis carefully hidden r 



EXIT: OUT •) 



You're at the floor of the slabalisation chamber. The 
floor itself consists of alternating concentric circles of 
gold and silver, with a small silver centre. A closed door 
to the west has a badly damaged alpha-numeric keypad 
beside it. 
EXIT: (UP S) 



14 
(Start) 



You're al the crew's mess. Various tables, stools and 
foods are strewn about, whilst in one corner a body 
quietly decomposes. The only exit is to the south. 
EXIT; SOUTH 11 



This is the corner of a lengthy corridor leading from 
south to east. Although it seems safe, you have a strange 

EXITS: SOUTH 12, CRAWL 9 



This ll the laic Captain Conl 
Chairs, desks. b|mg i ahinets, e; 
plush ijrpel (overs the floor. 
the onK door. west. 
EXITS: CKAWI B,(ENrtK13) 



e the walls, whilst a 
curity beam guards 



You're at the Bridge of the Astrodus, or what remains of 
it. Debris and ruined machinery betray an ugly battle, 
Captain Gontra being one of the many casualties. Doors 
lead south and east. A drawer is set into one console. 
EXITS: SOUTH IB, (EAST 15) 

15 

You're in a plain, compact corridor leading directly west 
to east. A small silver disc is set into the floor. 
EXITS: EAST 16, WEST 14 



Well that, I'm afraid, wraps up this 
month's instalment. As I have already 
said, next month we will look at the 
remaining locations in this same brief 
format together with a bit of vocabulary- 
After that I shall start to provide you 
with some information that should help 
you to complete this excellent 
adventure. See you all again next month. 
Have a happy holiday! 



REVIEW' 



(CBWPC-UNK 



Lt long last, a bit of kit to enable you to hook up your C64 peripherals (o PC hardware 



Over (he last year or so, there has been a substantial 
increase in the purchase of IBM and Compatible PCs - 
most especially with the advent of the cheaper Amstrads, 
Commodores, as well as the many 'unheard of before' 
makes, etc. This is truly great for all of us enthusiasts and 






, but ■ 



mple, 



ilh i! 



* to t 



I the 



ted riata/iiles/programs/etc frot - 

faithfulls - C64/128, Plus/4, and VIC-20 - over to the 
newly purchased PC. Not only that, but how many of us 
have now got CBrVl peripherals, such as printers and disk 
drives which function mainly as dust gatherers) Or, to 
put things another way, let us say that you, our faithful 
reader of CDU, are seriously ainside'in;; a new addition 
to your equipment - namely a land didn't you guess the 
next word?) PC. Well, no longer do you have to wnnv 
about buying a new printer, whilst trying to sell your old 
CBM one... No longer do you need to worry about your 
disk collection which is all in CBM Format... All this has 
now been taken care of in one fair swoop! Yes, your 
Commodore printer wilt be e.isiK re adapted to use with 
the PC (and still, of < oursu. with your CBM computer). 

DONT JUST BIN THINGS 

All those text files, and data files you may have, are now 
a problem no longer - easily transferable onto your new 
and ultra-expensive IBM(!?L 

"Well", you might be asking,"how came? What do I 
need? Where can I get one?" And, most importantly, 
"how much do I need to fork out?" 

First of all, what you need is called a CBMPC-L1NK, 
and from where, or rather whom, you can obtain such a 
prize is: 

YORK ELECTRONIC RESEARCH 

THE PADDOCKS 

JOCKEY LANE 

HUNTINGTON 

YORK 

Y03 9NE 

Telephone: York (0904) 610722 

And the PRICE? A nicely affordable £34.50 which 
includes VAT and postage. 

Judging from the address of York Neuronic Research 
you might think this is a bit of a gamble - let me hastily 



WHO ARE YER 

Who are YER lyou can easily work out the abbrevsj? 
Maybe many of you out there in CDULand will 
remember them. From 1986 up until 1989 they 
marketed their own Commodore 64 products, which 
included programming tools. Viewdata software, as well 
as their own RS232 interface. This new product from 
YER may seem unusual and interesting, but given their 
previous track record with C64 involvement il does 



illy folios 
especially a 

development. 



i from their development efforts - 



ring thei 



i PC 



MONEY WELL SPENT 

So, what will you get ior your hard earned thirty-four and 
a half quid? Well, apart from the result of years of 
development skills, you will receive a CBM-PC cable 
which consists of a 6-pin DIN plug, suitable for CBM 
devices, and a 25-way D connector suitable for 
connecting to the PC, and each joined together with 
about six feet of multicore. With this comes the driver 
software on disk - when you order you will need to tell 
the guys and sal? ;it Yl-K whether vou want a 5.25", or a 

3.5" disk. 

Care needs to be taken when connecting the cable 
between the PC and the peripheral. You must be sure to 
Identify the correct port, most PCs have at least one 
parallel and one serial interface - this is not CBM serial, 
but R5232. You must identify the parallel port. 
However, il must be said, it is tricky to go wrong because 
the serial port is male orientated, and the 25-way D 
connector on your cable is also male orientated. 

The driver software will allow CBM printers to be 
accessed as standard PC devices, like LPT1 and PRN. All 
DOS and BIOS printer facilities are fully supported, with 
the full ASCII character set being available on all printers, 
and Epson graphic emu I at ion ior some CBM dot matrix 
printers. 

The file transier utility will read data directly from off 
CBM disk drives. Files can be selected for viewing and 
transfer from the disk's directory which is listed in a 
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GETTING UNDER WAY 

When you insert your CBMPC disk in drive <A> and 

enter, at the D05 prompt, SETUP, the installation utility 
will run. This will lell you how many parallel ports yoii 
have, and will display the main menu. Here you cap test 
the cable which tomes with the package, let the printer 
and disk drive, deal with the first time installation, and 
set up - or remove the printer driver. 

When you select FIRST-TIME INSTALLATION from the 
menu options you are asked for a target drive and a 
subdirectory. This is where CBMPC will be installed on 
your hard disk. 

As I said earlier, the printer drivers support the full ASCII 



!"#$%&'()-+,-./01 23456789:;<=>? 

@ABCDEFGHI|KLMNOPQRSTUVWXVZ( \ 

'abedefghi j klmnopq rsluv wxyz 

(plus the UK currency symbol: I ) 

The textmode of the basic CBM printers stops at that. 
However, other printers do have additional facilities Mich 
as bold, underlining, and graphics: 



a directory listing in the familiar CBM format, with file 
size in blocks, and PRG/SEQ extensions. The top line of 
ihe screen shows the disk name and ID, whilst along the 
bottom line is a list of 'function key' options - which does 
include my favourite <HELP>! 

Vou are able to tag highlighted files - or untag them if 
necessary. read\ ten batch transfer. As you tag them, a 
display next to the file will state -pending=, and after a 
successful transfer this wiil . Mange lo the familiar CBM - 
Tn >.f. ik. 010,00"=. 

There are also many advanced features incorporated, 
such as changin..'. file types, performing PET ASCII to real 
ASCII, exact copying m binary which cm be displayed in 
hex-dump iorm.it. the dclukenising of PRC files into text 
tiles suitable for PC BASICS which can then be loaded 
into GW-BASIC and modified to run on the PC, there is 
also conversion of PET screen codes to ASCII. CBM 
I 3-11 disk drives will also read old PET 2040/3040/4040 
disk formats, which means PET wordcraft word processor 

files can easily be converted. 

You are also able to copy the 
■ntly highlighted file into a 

temporary buffer from where it 

can then be displayed o 
!t\, and finally you ai 

be admitted, tiles 
from the PC to a 
CBM disk drive. 




The industry standard 
dot matrix graphic 
code defined 
by Epson 



the CBM printers. 

MPS B01/803 and VIC 

25, but the VER Epson 

II translate Epson codes into 

CBM graphics. Illustration. 1 demonstrates 

mple output of Epson graphics. This was 

generated using Xerox Ventura Publisher, and printed on 

""■ isingMPSEPSON program. 



a Commodore MPS B 



CBM-2-PC FILE TRANSFER 
PROGRAM 



Once you've got this program running, the si 



CBMPC-LINK REFERENCE 
MANUAL 



With the cable and the software c 
reference manual. Fifteen A4 pages complete with all the 
instructions needed, as well as information, advice and 
examples which cover every aspect of this unique, 
unusual, interesting, jphI desirable- pai kage - definitely a 
must for those people with CBM and PC equipment at 
their disposal. 

I could have spent another dt 
celebrating this neat utility that will ■ 
bonus for many people, but the edito 
said, "hold on there bald eagle, there ai 
go in the magazine you know, Rave!" 

"All right then." I softly acquiescent. "However, I must 
nnallv say. congratulations to YER for introducing the 



ten or so pages 
rely prove to be a 
in all his wisdom, 
e other things to 



CBMPC-LINK." 



FEATURE 



PROBLEM 
SOLVING 



If you have jusi 
program and hav 
blank screen ther 

reading. 



had a superb idea for a computer 

been sitting slaring blank faced at a 
JO switch off the computer and continue 

FIRST STEPS 



The very- firsl step in solv ng .1 problem is n ;i.i il \ 
a problem to solve. Have you had an idea for a superb 
program? If not then go away and do anything except 
rack your brains to think at .1 superb idea. The one sure 
way of clearing your mind of anything in the nature of a 
superb program idea is to actually try to think ol one. 
Have a game of 1 boss, have ,i sleep, ,1 bath, watch some 
T.V, play some 1 ompuler games, but don' I try to think ot 

an idea for a program. 

Another important factor is your ability to solve the 
problem. Thinking out the problem will make the solving 
or it easier but you most be able to ■jnlve even the easiest 
of problems, li you are unable to program then this 
article is not, I'm afraid, for you. 

So, once you have discovered what your problem is 
then you have reai lied the mid point of solving it. 

But you must noi think oi solving lhe program in terms 
of commands and routines. First of all you must discover 
if the problem \ou wish to solve is feasible. 

FEASIBILITY 

rojsihilily simply means: car. the language you will be 
using undertake your program eili< ierilly? Is the program 
you wish to write worth writing in the language vou 
haver 

If, for example, you had a sudden brainwave (whilst 
playing trivial pursuit) that you could write a 
wordprocessor. but vou only knew BASIC, then would it 
be worth doing it? Even if you compiled the program 
using your 'up to 40 times faster' compiler would the 
program be sufficiently fast enough? 

This particular problem is ralhcr hard to gauge and 
would probably involve the use of compiler tests - small 
programs of your own creation which perform scaled 
down versions of iiinctions which you wish to include. 
Screen updating is impodani with a word processor, so 
you could write a small program to dump a section of 



memory, which could be the text, to the screen. If this 
lakes ages when compiled then a wordprocessor is a 
definite no-no. 

Another thin;; lo consider is the need lor graphics. A 
word-piniessoi would not require them. A DTP package. 
On the Other hand, would. Using uriexlended h4 8ASIC 
to write a DTP package would require a great deal of 
staying power and patience on the parts of both 
programmer and user. 

So, to execute a feasibility study you musi look at your 
problem and what features it will need to be successful. 
Then you must look at your computer and see if it is 
capable of carrying out or providing these features 
speed iK and. more importantly, without sending you 
insane in the process. Then you must look at yourself. 
I lave vou got ihe mental stamina to linidi what you will 
start? Is your mind logical enough to figure out any 
equations ui programming constructions which will 
make the program run more smoothly? If the answer the 
ihis last 0|Li(.'Siloii is no then, although vou may finish the 
program, it will probably end up inordinately large and 
i omplii a ted. Not only will il lie impossible to read by 
anybody else, mil you will probably find Ibal you can't 
read it either and this is a tremendous problem if any 
small error shows its head. 

So, then, the personal requisites for successfully and 
eifiriently solving youi problem, apart from an ability to 
program, are 1) A logical mind, 2) Patience, 3) Able to 
see dead ends and go onto another track. 41 Staying 

Unfortunately not all of us have ihese qualities in great 
abundance. I low-ever, with a bit of work and a wish to 
improve, we can adopt them and make good use of 
them. So when you get an urge Id give voiir keyboard ,1 
battering, ihink again anil make a lew notes. When you 
are teaiing out your hair liei ause of an unrraceable error, 
save the program and have a resl and then go through it 
again ■.villi ,i nesh eve. When vou i"nd voue.'Ti .. : ■= 1 ■ : : -- ;. 
bored because von are writing a partii ularly long bit ol 
( ode whit 11 isn't going lo do a great deal. Ihink of what 
the program will be like when il is finished, watch some 
l.v or read , : i hook and (lien ail jr. k the piogiam again. 

Basically it's all a matter of not pushing yourself too 
hard. The more you work that faster your level of 
plummets to the base line. 



-FEATURE 



FEATURE BOXES 

Once you have though! of the program as a whole, you 
must think about Ihe imHivrrlu.il bits .ind hobs thai make 
up the program. 

Write a list of the features you will require. It need not 
be ordered into order of exerul ion. you iti.iy alw-.ivs thinl 
of something essential laler on - just add it to the list. 

Don't thinl. about how you are going lo actually i ode 
the5eseparateelemenlsr.il' the program. Just writedown - 
word, an identifier, and proceed c " 

Once you have compiled a 
which you think conlait 
everything you 

next stage of development. It 
doesn't matter if you have 
inadvertently omitted something. 
' inything 
in r omjiuler 1 1 n. ■ 1 1 -1 1 j i- y so you < an 
add things and remove things 
later if necessary. 

The next sl,i;;e of development 

o actually order these -.inglr- 
of tl 
program. Note this is not a detai ed 
s just a diagram 
-Imv.-inj; tlit; order in which featuv- 
of the program art* lo be executed 
It is a good idea to separate these b) 
bones - feature boxes. 

lething 



going lo the respective boxes. 

Always remember thai 1 1 ■ 
diagram IS showing the flow 1 I ■•■ 
program. And it is a good idea !o keep 
this in mind. Start at Ihe top of i larjjr 
sheet of paper and work your way down. 
Features from the same menu should " ' 
plain. 

SUB-FEATURE BOXING 

Once you have reached lias stage you can begin to SUB- 
FEATURE BOX. Vou must think about each of the nature 
boxes you have created and try to split them down 
further. Vou need not actually write this down - jusl think 
about il, although it is a good idea lo make rough notes. 

Then you can see if there are any juris of ihe feature 
thai, when coded, couirl he used bv other lealures. Sui h 
as prinlinH text in Ihe middle of the screen. II" this is used 
In several features then it is a good idea to set this up as a 
sub-subroutine. Or if there is a lot 01 disk access in the 
program then you could have a sub-subroutine which 



r reads a specified block into the 




gets the filename, 1 
buffer or whatever. 

Then you can draw anolher feature box diagram. This 
"lie with (he sub- sub routines not connected to the main 
construction. Draw the boxes like before and, whenever 
you came across a fealure box which makes use of one 
or other of ihe sub-subroutines, then write the name of 
that sub subroutine in the box with the feature name, 
preferably in another colour. 

Once you have this fully done, it will occupy a lot of 
last, get down to the programming of 
your program. Vou can program any part 
program in any order, and it is 
oilen better lo do it backwards as 
this gives a different 
perspective on the subject. 

DEBUGGING 

" ig written your program 

and tested it and found errors 

in it then it is a good idea to 

debug it. Good, because if you 

don't then you'll never be able to 

use your program ever again. 

Debugging is made particularly 

easier when you have programmed 

me style mentioned above. You simply 

h.we to take listings of the routine 

here the error is reported then 

islings of any sub-subroutines 

called by that error and ihen 

follow the code through, thinking, 

: - your head, what is going on. 



appro 



s the 



confused with utiles and miles of 
program scrolling before your 



STRUCTURED 
PROGRAMMING 



alw 



t the 



words STRUCTURED PROGRAM- 
MING and found the thought of actually doing 
'i ■ ■ ■ ' ng, then don't. Following the method of 
preparation sel out above, slructure, in your final 
[ire-gram, is practically automatic. Vou have split the 
program into Mriijili- |j,irts and that, I'm airaid, is as far as 
slructure exlends on the 64. 

One point is you must never jump out of a routine. 
Always leave il in the correct fashion (RTS or RETURN) 
this keeps the stack in good order and makes everyone 
happy. 

SO GET ON WITH IT! 



m afraid that there is little mare I can say 

ial would not involve writing your progra 
jite simply, get on with it. 



i this subject 
1 for you. So, 



PROGRAMMING- 



MULTITASKING 




MODULES,PROGRAMS and TASKS 
DAVID KELSEY 



We provide a breakdown of all Ihe modules necessary to 
implement our multitasking concept 

Last month we gave you ihe background needed for 
implementing MULTITASKING on the C128. We also 
provided all ihe "ASM" mcxLulos needed to RLIN such a 
system. On this months disk is the program needed lo 
"DISPLAY" these "ASM" files so that you can see what is 
going on. Insert the disk into the drive and type 
liLN"[">i-|il,iy.kiV". llns will :i uil and M', Hi.p .». "I ■' n - 
is not loaded. Vou can then view or print out each of the 
files as necessary. Please note., if VIEWING the tiles, you 
can only do this in 80 column mode, the PRINT mode 
allows for 40 or 80 columns. The "UP KEY" moves up 
through the code. The "DOWN KEY" moves down 
through the code. The "LEFT ARROW" exits the current 
file and the "P" key will print the file. [S key to stop). 



STOR.ASM 



FINAL NOTES ON LAST MONTHS 
TEXT 

This implementation is a simple method, however very 
simple there are some problems that can occur with the 

implementation. 



B) Memory fragmentation. Suppose that the only free 
storage is 

$5OO0-S5TO0 and S8000-$8200. Now we want to use 
some storage of length 

$0250. Even though ihure is the storage, because it isn't 
is lie fragmented i the 'iiir.ii 1 ,' isn't available. 



A SOLUTION TO (A) COULD BE AS 
FOLLOWS: 



Instead of defining ,i sl.itk table, every time a new entry 
is lo lie plated in the table, find some storage and build 
the entry. Then using links you could chain the entry 
onto the other entries. A search can be done of this 
chained table in the usual manner. This would be the first 
modilicalion lo the system, but it is a re-write of the 
entire table logic and ihe logic would be complicated. 
The cleanup code in the above module is a simple 
attempt to try to deal with this problem, 



(b)ii 






. Ther 






Blocks of storage could lie moved to try tc 

concatenate these blot U of storage. However to do this 

would leuuire the mnv r :-.;; of lae;e hit" k> of memory and 
if any of this is code, then it would have to be relocated 
lie all absolute addresses would have to be converted). 
This could take quite some time to do and the delay 
would be iiutked. Anolhei solution is to 'page out' the 

PAGING OUT 

This is a complicated idea and is based on the fact that 
whenever a program is running, only one instruction is 
ever being executed and only one memory location, 
apart from the instruction, is ever needed. The rest of 
memory is redunrienl. So whole block- of memory could 
lie placed on disk until required. The code could then be 
loaded in when required anywhere and control could be 
transfered. This could introduce programs which were 
tragmeriU-d .ill ovei memory, but could still run. This 
concept is very complii ated to implement and won't be 
discussed any further. 

PROGRAM TABLE 

The other table that the system maintains is Ihe program 
table. For any program that is loaded and run, certain 
information is kept. Some of it is for the use by the 
operating system and some ■* l, .eipiul for display so that a 
person can interrogate the operating system to find out 
inrorm.iliori about the programs running. 

INTERRUPT INFORMATION 



-PROGRAMMING 



processor uses to run a program has to be 5aVed,When il 
is lime to return (o thai program, this saved Information 
can be brought back and the program continues as 
though nothing has happened. 



foljows:- 



required to be saved i: 



A - Accumulator 

X - Index register X 

V - Index register Y 

SR - Status register 

As this is put onto the stack, all that has to be done to 

save stack information is to mow Ihe stack and pl.n e the 

STACK POINTER in the program table. 

As described earlier in this series, the special abilities of 
the MMU to move the location of Ihe stack and page 
zero are used. So for each program its associated pa^r d 
and page 1 areas are stored so that they can be pointed 
to when the program is returned to to be executed. 

The final information stored in the table is the program 
name and where it is stored in memory (the start and end 
address). When a program is removed you need to know 
what areas of memory are freed up. 
So ihe final layout of the table is below. 



EQUATE 

This module defines ihe p,ie.e zero layout. It is best to 
define the all page zero definitions at the start of the 
assembler eode. This is because the assembler, when it 
comes to a label, will automatically allocate 2 memory 
local ions il il isn't defined, (this is a problem if you define 
il later to be a page location). Commonly used values 
are also lielined as euuales .mil special memory locations 
are also defined here, (.'heck moduli' named "EQUATE 
V 1.1. ASM" 



I hese routines arc called l>v manv other modules and so 
are called common. There are no other special 
connections between the routines. 

READNAME 

This routine is used by all the command processing 
modules encountered later. 1 1 will pull I lie program name 
entered on the command line off and store it in a 
memory block. 

CONVRAM 

This routine converts the BANK value which I have 
defined in the program table lo a useable combination 



FLAG 


PRP 




STRT 


END 
ADDR 


35? 


ZERO 
PAGE 


ONE 
RAM 


ONE 


PRIORITY 


STACK 
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TG 




2 


z 


1 


1 


1 


1 


1 


1 


NUMBER OF BVTES 







a field in the table called PRIORITY. It 
isn't used at present but is explained in Ihe expansion 
section later in this series). 

The individual routines that are used on Ihe table are :- 

SETTAB - initialises the program table 

LOCNAME - locales the table entry which has the 

program name specified. 

LOCFREE - locale a free entry in the table. 

It should be noled that this table isn't maintained very 
centrally. Other routines actually modii\ ihis table. These 
jusl provide some basic functions on the table. Check the 
module named TAB. ASM at this point. 



FINAL NOTES ON THE ABOVE. 

Again, the table can fill up. Therefore there is a limitation 
of the number of programs that can be run. The number 
can be increased by increasing the size of ihe program 
table definitions in the assembler code. A way to make 
the number of programs running unlimited (limited onlv 
by ihe amount of storage) is to use Ihe chaining melhod 
described (or Ihe storage table previously. 

OTHER MODULES 

Before going into the 2 main sections of this operating 
system I want to describe some of the other modules thai 



INIT 

This routine sets up the 2 tables which are used by the 
operaling system. Il does other initialisation procedures 
which will he described later. It sets up the memory 
configuration that is required as well and also displays a 
message lo say that the system is ready. The memory 
n induration consists of HAM, I/O + common storage. The 
memory map that is setup during INIT is as follows :- 
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Willi Ihe l<: 



jking like :- 



SOOOO - SOOFF Operating System page 
$0100 - SOI FF Operating System page 1 
$0200-$02A1 Keyboard buffer 
$02A2 - S02FF LDAFAR eic routines 
$0300 -$0313 Unused 
$0314 - $0319 IRQ, NMI and BRK rectors 
$031 A - $0333 Load/save/serial vectors 
$0334 -$03FF Unused 
$0400 - S07FF Screen 
S0800 - S0FFF Unused 



no other program has to be located. So this routine 
should just automatically return to the program running. 
The IRQ routine only checks to see if it is a raster 

interrupt. If it isn't then no action is taken. In he fullness 
of time, all the possible different IRQ's that can be 
^ern-r.ili'il need In lie processed, [his is discussed in the 
expansion chapter. 
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program is terminated and removed from storage (i 

storage is treed). All that is done is the program table 
entry is reunited ant! the slorage used by that program is 
freed. Another program is then located and it is returned 
to as though a normal interrupt has occurred. 

PROBLEMS WHEN BRK 
ENCOUNTERED 



MESS 

This is a centra iised ; Message routine thai makes il easy to 
add a new message to lie displayed. To add a message, 
enter the message and define a label to it. Then put the 
label in Ihe label list at the top of the messages. Look it 
"MESS.ASM". 



SCREEN 

This routine provides a very simple screen driver for the 

up' latin,: S\ Skill. V I "is ■: iCiei.Cieg -V. lei 11 is lo pi:-, ilie 

all control aver the I/O. The operating system requires 
control over a screen to display messages and allow 

communication to the user. It relies on the screen being 
defined a; 'oral ion MMI'I) and works hv having a * ursor 
location pointing to the next place on the screen where 
the next character will go. Examine '^("KEEN.ASM". 



This is the main routine. This routine is the one which 
actually swops programs around making it appear as 
though several programs an: running. This routine has 2 
main parts. The stand a id IK( > routine whin h is geneialud 
by a raster interrupt. The other is when the 8502 
command BRK is encountered, this is a type of IRQ 
interrupt and must be catered tor. 

IRQ 

When an interrupt occurs. The operating system is 
entered. The iirsl thing thai must be done is to set up the 
correct page zero and page 1 for the operating system. 
The required information about the program running 
must be saved. All Ilia! is required is to save [he stark 
pointer in the program table. Pointing lo Ihe sy.iem stark 
when entering Ihe operating system save? the H~i02 
registers as the interrupt routine has placed them on the 
stack. A new program must then he located. Once this 
has been done, then ihe routine must simulate a return 
from interrupt bar k to ill is program. This can be done by 
pointing lo ihe new program's slai I and | lulling the stark 
pointer off the program table. On Ihe return from 
interrupt ihe information is pulled off this slack and so we 
get the last saved information ol thai program going into 
the CPU registers. If only one program is running, then 



Ther 



,s:del I-I0I 



egavdm 



do when a BRK is encountered a 

number of progiams aie running. If only I program is 
running, and il encounters a BRK Ihen whal happens? 

Tile processor mtisl letum to some sort of code after the 

interrupt is > ompien il. [''ereiore we reuni :■., i looping 
program that is eniouiileictl when ihe opeialing syslcrn 
is iirsl initialised. 

LOOPING PROGRAM 

This logic is found in the initialisation code UNIT). Il is 
just a loop consisting oi one instruction IMP. When the 
system is first initialised and no programs are running, 
tbere is nothing to execute. As the CPU cannot be put 
into any sort of wail slalus and must be doing somelhing, 
all thai it doe- is loop. When programs are started and 
terminated hv ill' svsii i-i. i: tie run I.-, i oi programs drop 
from 1 to 0, Ihe CPU must execute something, so the 
operating system jusl returns to this looping program Until 
a new program is executed. Look al "IRQ. ASM". 

THE COMMAND INTERFACE 

1 here neerls lo he a way lo load programs in and control 
theii operating so sorue soil ot i. unsmand interface was 
devised. The need was that you should be able to 
request access lo Ihe operating syslem a! any lime. As 
NMI can never be suppressed thin seemed to be the best 
way to access Ihe system. So whenever the RESTORE key 
is pressed. Ihe i iperating svslem prompts for a command. 
The NMI module does jusl thai, it prompts for a 
command then decides whether the command is valid 
and if it is, parses ihe i.ontiol to I In- appropriate module. 
The NMI routine Sels Ihe inlerri.pl ilai; which effectively 

possihle lo have both die operating svslem processing 
commands while all other programs were running, but at 
present there are some problems with that, so it isn't 

The code is ihe inieilace diai processes ihe input from 
the user. The aclual routines that process ihe commands 
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are in separate modules, these will be discussed later. 
Note that the first cheat is in here, I use the CI 2fi 
operating system to poll the keyboard. 

Note that on interruption that certain information about 
page and page 1 and the stack pointer are saved. This 
fs because we are now in the operating system, we need 
to switch over to the operating system 'st.ii k and page 0. 
II is quicker to jusl record this information rather than 
pull it off rbe table. Checkout "NMI.ASM". 

COMMAND MODULES 



opcuiing system In rinrl and allocate space lor a program 
to be loaded, it has to know the length of the program. 
Tin: execute /idling <>i ; his program must also be given to 
the operating system. The normal load and save routines 
in the CI28 operating system don't use this kind of 
information, so some modifications need to take place. 

NEW SAVE ROUTINE 

This routine MUST be used to save a machine code 
program which is to be used in the operating system. It 
saves the start address, end address+1 and current 
execute address which you specifiy when saving the 
program. Civing the end dddress effectively defines the 
length ol the program. Giving the execution address 
defines fir-ilv where execution will start and where code 
begins for the relocation routine. 



CLEAR - This routine jusl clears the operating system 
screen. To execute, type 'C\ II uses the clear screen 
feature of the screen module. (CLEAR.ASM). 

PROGSTOP 

The routine provides 2 commands. One is the Suspend 

and the other is quiesce. Suspend stops a program from 
executing, bul leaves it in memory so thai the program 
can be restarted up. Quiesce stops the program and 
removes it from memory, This memory is freed up and 
can be used for other purposes. 

S prgname - to suspend a program 
Q prgname - to quiesce a program 

Some problems weic eni ouritered however on the firsl 
attempt to code this. What would happen if we 
interrupted a program and then tried lo suspend ir quiesce 
it ? There is no problem in suspending or quiescing ,i 
program which isn't currently using the CPU, all that has 
to be done is set the flag in the table appropriately and if 
quiest ing it then the memory must be released via the free 
storage routine. If we have to stop the program that is 
running then when the return from the NMI routine is 
executed, it cannot return to the program that has just 
been slopped. This means that you have to locate another 
program to return to, make it appear as though that one 
had been interrupted Iw the NMI routine and return to it. 
If you suspend or quiesce the final program, then we must 
return to the looping program which was firsl executed at 
theendofinitijlh.nl, in. 'I'KOGSTOP.ASM). 

RUN 

This starts a program which has just been loaded or 
restarts a program which has been suspended. Again a 
problem occurs when you try to run the very first 
program. On return of the NMI interrupt you have to 
return to the progrjm you have just spei ilied to run. This 
is done by fooling the NMI routine into returning to that 
program by changing the information he has saved about 
tin- program lie has interrupted. To use the command, 
type: R prgname, (RUN.ASM). 



USING THE NEW SAVE ROUTINE 

The program has to be loaded into memory first, away 
from the new save code, which is placed at SI 300. To 
initiate the code, type SYS DECH300") in BASIC. To 
use. first place the execution address in location Jfa and 
Jfh. Then to save, use the machine code monitor save 
command as normal. For example :- 

program at $3000 - $32A3, RAM 0. Execution at $31 22 



BACK TO THE LOADER 

I would have liked to design my own loading routine, but 
to do this properly allowing for application routines to 
also access the serial port would require a lot of work. I 
decided to cheat again and nick some of the code from 
the CI 28 operating system. To design a proper DOS for 
the new system will be quite a task and is pan of future 
expansion. The C12H code had to In: modified, so the 
whole of ROM from $e000-Sfft)0 is copied into memory 
to allow easy modification of the load kernal routine. The 
first modification to the loader is to read in the end 
.address .-,n,:i e>ci uliun address irom the information on 
disk. This means that the length of the code can then be 
determined anil a suitable section of storage for the 
placing of the information can be located. The kernal 
load routine resets the interrupt flag. If it does that the 
operating system will Mart swopping the programs and 
the system will crash. The parts of code that do ihis have 
to be removed. Finally certain kernal calls have to be 
removed as they serve no use and could cause problems. 

The modifications .are clone .it mil alisation time and all 
mods are stored in a patch table. To use the load routine, 
type: L prgname 

There is logic in the code lo specify .1 priority. This isn't 
used and the priority idea will be given in the expansion 
section later in the article. 

The loader loads the program into memory and sets up 
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Ihe program table entry as well as locates areas for page 
and page 1 for the program. Please note that Page 
and Page 1 for a program can be anywhere in memory. 
They don't have to be close to the program or even in the 
same RAM block. ("LOAD.ASM"). 



RELOCATION ROUTINE 



Summarized below are the results :- 

x8, AA, 00, 40, 60 - implies 1 byte 

xC, xD, xE - implies 3 bytes 

x9and 1st 4 i 
is set) implies 



relocation routine. The first problem is how to decide 
what is code and what is data. A relocation routine could 
mistake (lata for code and change information that you 
don't want to change. The format of the program should 



locations used by prg 



When you specify the execute address, the routine 
assumes that from that address to the end of the program 
is all program code and no data. This should be true and 
is discussed further in the programming restrictions 

The main problem with this routine is after processing 
one assembler instruction, how many bytes do you move 
forward from that instruction to get to the next one. Also, 
it must recognise which instruction is followed by an 
absolute address. Once an absolute address has been 
found, it is then checked to see if this address Is within 
the program block and thus needs to be changed to fit 
into the new address that the program has actually been 
placed at. The problem is Still, how do you recognke lhe 
'length' of each instruction. The first way is to just have a 
table of everv s i riv; Nj instruction and a^ijin the number of 
bytes that thai .isss-mbls-i' instruction is. For example LDA 
S4000,!i is a 3 byte instruction, and INX is a 1 byte 
instruction. There is however a relationship between the 
length of a machine code command and the byte value 
ji- sod. lied with that command. 

1 Byte commands 

ASL A 0A LSR A 4A RTI 40 TXA 8A 

BRK 00 NOP EA RTS 60 TXS 9A 

CLC 18 PHA 48 SEC 38 TVA 98 

CLD D8 PHP 

CLI 58 PLA 

CLV Bfi PLP 28 

DEX CA ROIA 2A 

DEY 88 RORA 6A 



e that 



a patter 



commands apart 

from 3 have the last 4 bits either 8 {1000) oi 

If you look at the 2 byte commands 

commands in a 

similar manner you will be able to see pat 



i the code is ther 



BRINGING THE MODULES 
TOGETHER 



That's all the code needed, the only thing now is to 
assemble them all and put them together. Here is the 
module order that I used to assemble all the code. In the 
Lazy Crenius assembler, this file is the one that is 
assembled, the other bits of code .ire pulled in off disk to 
be assembled at the appropriate time. 

ORG $1300 

(MNCLUDE "EQUATE.ASM" 
JflNCLUDE "INIT.ASM" 
(HNCLUDE "COMMON.ASM" 
#INCLUDE "TAB.ASM" 
fflNCLUDE "STOR.ASM" 
SINCLUDE "IRQ.ASM" 
('INCLUDE "CMD1.ASM" 
#INCIUDE "LOAD.ASM" 
#INCLUDE "DISP.ASM" 
#INCLUDE "RUN.ASM" 
//INCLUDE "REIOC.ASM" 
#INCLUDE "MESS.ASM" 
#INCLUDE "SCREEN.ASM" 
#INCLUDE "CLEAR.ASM" 



CODING APPLICATIONS UNDER 
THIS OPERATING SYSTEM 



Although I tried, 
operating system 



ime limitations have to be placed on 
ing applications to run under the 
'hese are not guidelines, but rules. If 
followed, you are liable to crash the 
a program that won't work. 



RULE 3: Code design. To make sure that code relocation 
is effective there are certain ways in which code should 
be designed. This will be described in a minute. 
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RUIE 4r Use the I/O registers at your own risk. 
Remember that several programs could access them at 
the same time causing chaos. 

RUIE 5: Using interrupts is dangerous. It may be 
possible to trap them yourself by changing the interrupt 
vectors at locations $0310-$0317 (as normal) but you 
MUST return to the operating system routines. You 
could still crash the system. 

RULE 6: Be wary about using SEI and CLI. If you SEI, 

you stop the upeialing system swapping programs. 
Really they shouldn't be used in application programs, 
only operating system routines. 



ROUTINES FOR APPLICATIONS 



RULE 7: All non-zero page locations must be contained 
within the code block loaded (ie a program which 
could be starting at $2000 - $23FE should have all its 
memory locations that It uses placed within that 
memory block). If you don't, you could affect other 
used storage locations which the operating system has 
allocated In another program. 



;, be c 



ef u I about 



RULE 9: Vou cannot use coding routines such as 'LDA 
#<ADDRESS' or set up address tables using assembler 
mneumonics such as 'DW (define word). The relocator 
won't cope with this. 

CODE STRUCTURE 

For the relocation code to be able to decipher which is 
code and which is just data so that it doesn't try to 
relocate data lhal it mistakes for code, there has to be 
some rule to follow:- 

You must put all data areas at the top of the program. 
Vou can define the execute address and this is where 
the relocator will start relocating the code. Therefore it 
won't touch the data at the top of the program before 
the execute address. 

CODING EXPANSIONS TO THE 
OPERATING SYSTEM 

There are 2 points to consider here. One is the 
expansion of the code such as adding new informatior 
to the tables and the second is to provide executable 
routines that can be called by applications. 



There is a hell of a lot of work here. Expansion here 
could be to provide facilities to control the access of I/O. 
[wrnpk- ■.-.ill be given in the expansion section later. 
The most important consideration here is the concept of 
RE-ENTRANCY. What happens if you call a routine and 
during the running of this routine the program is 
Interrupted to run another program. The next program lo 
be run then calls the same routine. (This routine is an 
operating system function). Calling this routine would 
change some memory location which it uses. When we 
return to the first program that was interrupted, it would 
return to this common routine to find that the values that 
it had set have now been changed. Unexpected results 
would occur. It isn't possible to provide copies of these 
routines to all applications that may call them so how 
can we get around this problem What you need to do is 
for each different application that calls an operating 
system routine, have ,i diiterfnt block of work locations. 
The way larger systems do this is by getting a block of 
tree storage tin entry to tin: routine. This free storage stays 
unique to the register is only ever used to point to this 
block. The block then gets used to store information 
while the routine is processed. -\n interrupt now occurs. 
The routine is temporarily interrupted. Another part of 
software then calls the same routine. On entry a block of 
tree storage is got. Il is riiiierent to thy first block got by 
the 1st caller to this routine because the area has been 
flagged as used. The register now points lo these memory 
locations and so the routine is working with a different 
piece of storage and doesn't corrupt the 1st callers 
storage. As registers are saved at interruption time, the 1st 
caller hasn't lost its register that contains the pointer to 
it's block of storage. When the routine finally completes, 
it frees up the storage that it has used. 
What this looks like is that one routine has blocks of 
storage allocated to it when called. It could have several 
blocks defined to it, each unique to the caller of the 
routine. This is basically simulating an individual copy of 
the routine to each caller. Only ihis way a share copy of 
fixed information is kept and a unique block for all 
changing memory is assigned to each caller. This method 
also copes with the fact that you don't know how many 
calls are going to be make to the routine that will run 
concurrently. 

How can this concept be used on a CI 28? The problem 
is that you cannot use registers to point to memory 
Icm alions. (Index registers are of no use as a register must 
point to the whole address tor it to reference). There are 
no 8502 commands that provide something like:- 



EXPANSIONS TO THE OPERATING SYSTEM 

Possible expansions are to the program table by adding 
extra entries in the table, or by providing new 
commands to the operating system or by updating a 
module. There is no special programming techniques 
required here and just experience in assembler is 



is of the 



The way round Ihis is to remember the PAGE 0. Because 
oi the facility to mow PAGE t'j. each application has its 
own PACE (and PAGE 1 ). So this provides ihe separate 
block of memory. When entry is made into a common 
routine for one application, the address 140 for that 
application will be different to the contents of $40 for 
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Another application as they are effectively -' different 



. This 



s that a 



absulolelv reference a h nation, hut il will be diiie'ent lor 

If you don't have enough storage in page 0, you could 
use the GET STORE routine lo gel ;i block of Murage, ihen 
indireilA audrer.r. thi- Mm l> using |>-.'i0.i>( i | 10 '■-'i- .■■ 

sure you select ihe RAM bio. k ih.il the operating system 
is in. You could use any RAM block but then you would 
have to addres, die memory locations within the routine 
via LDAFAR and STAFAR. described in the MMU article. 
which could unnecessarily compile ale things. Usually 
though. Page and Page 1 would provide sufficient 
storage for all purposes. For any operating system 
routine, you will need to document which paged 
locations are used so as lo not conflict with other 
operating system routines as well as the calling 
application. 

To code these routines requires a special way. The call 
will be in common memory and the code in common 
memory has lo have the following code 

1. Store the current RAM configuration (in page 0) 

2. Set the RAM i unfiuuraiii ti to ope iai 111:4 system one 
3JSRtOGode 

4. Reset RAM conliguialion lo the saved value 



OTHER PROGRAMMING 
TECHNIQUES 

SEI and CLI can be used in tempi iraiilv stop the operating 
system switching programs. This could be used to 
|i'nduce i wi;e ;;vil Jttualk ■. • ; i n | .■ c - 1 .. ■ ^ beioie ■motile! 
program is swilched lo. This means some code doesn't 
have to be re-entrant. Be careful using this technique. 
You could stop the whole system or slow other programs 
down significantly. 



KERNAL1 



VAL1 =$50 
VA12 =VAU + 1 

ORG S2F00 ;Well aul of way of operating syster 

EQU' 

STA VAL1 

AND #$0F 

STA VAi.2 

LDA VAL1 

AND#SF0 



LSR 

LSR 

|SR CONV2 

STA VAL1 

LDA VAL2 

|SR CONV2 

STA VAL2 

RTS 

EQU* 

CMP #$1 

BCS AF 



COMMAND CODE 



EXAMPLES 

I have done a couple of examples lo show the use of ihi 
system. The first is an operating system routine which 
converts a hejv.idoi ini.i 1 ■. aluc into J sc recn characters. Also 
provided is the code in common storage to call the routine. 
The 2 applications which I have provided are very 
similar. They poll the two TOO clocks and display them on 
the screen. 



RE-ENTRANT CODE 

code that converts the hen number ti 



* Here is the example definition of an operating system 
routine which can tie called In an\ .ipplii at on and is thus 
re-entrant this code must be loaded before the operating 
system is initialised. Here is the conversion code. 



•Here is the example definition of an operating systt 
routine which can be called by any application and 
thus re-entrant this code must be loaded before t 

i)|«-i,iliri;; -.v-li.'iii '■ ■■■svli-.i-c M--.I define r 1 1,-- .uinp lo I 

KERNAL1 = $2F00 



page: 



SAVE! = $FF 
ORG $0800 
PHA 

LDA$FFO0 
STA SAVE1 

LDA#S3E ;Operating system config 
STA SFF00 
PLA 

|SR KERNAL1 
PHA 

LDA SAVE1 
5TA SFFOfl ;Return to orig config 
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Operating systems take many man hours c 

develop. They usually start off with a bask system lhal Application 

works and [his is built on. 



application. The application request input again via the 
operating system tails. No oilier application ,h<wld gel 
Ihe inlormation.This could be achieved bv doing 
something like:- 



pmgra 



s l/Oc 



o program communication. 

sucn a:, more operating system <.,mr 
considered. The other path is to deve 
run under this operating system. 
Both these udeas will be considered ir 
approach. 



EXPANSIONS TO THE OPERATING 
SYSTEM 



TABLE IMPROVEMENTS 

As described earlier in this series on storage and program 
tables, the table control is very simple and limits the 
system and how many storage enlries exist. II would lie 
better to chain table entries to effectively remove the 



USER INTERFACING 

My idea for this would be to define a screen , 
for each application that is run. Tin- applir 
decide whether to use the screen or 

:e of the screen would be via onerali 



do until return pressed 

get inpul via operating syster 



operating system input r< 



Poll keyboard 

if key pressed then 

find ou I my program name 

am I currently being displayed f 

if yes then return keyboard poll 

You can locate which is the current program by looking 
in Ihe system page at area 'CURRENT'. A ilag in the 
program table could indicate that this is the current one 
being displayed. You could even have a separate pointer 
to say which program is currently being displayed and 
compare thai with CURRENT, 



X = X position 
Y = Y position 
A = character 

Call the routine to place this on application screen. Via 

Ihe op,..ialiog sv,it'iii v.,,.., can .,-,.,, : w h ( li -.; i (( -n i- 
displaved. A 'JUMP' key will switch the screens. This 
would be t-. i -. \ 1 iy [iM pointing the VIC II chip to the 
appropriate screen, h.ir Colour however, you would have 
lo swop the information into ihe appropriate area for 
colour. If an application was being displayed then you 
would have to update the usual screen area. The colour 
area used by Ihe application and the i olom RAM ^-v-. Ik- 
VIC II. (ie SDBOO - $DBFFI would also have to be 
updated. The operating system should also have it's own 
control screen. As for input, all user controlled input 
media such as keyboard and joysii, k should work as 

follows :- 

Which 



I/O CONTROL 






required to control all the remaining I/O 
mat is flvialable. This should deal with the all the I/O 
re^islers within the I/O block. There are 2 ways in which 
this could lie done. Tor well program, give them a set of 
shadow registers lor all the I/O. when the program is 
given (.PL! time, place all the I/O information into the 
registers. When the program stops, copy all the 

Obviously this idea cannot be used it you want to use 
real timers and get the correct lime, (this idea could be 
used on sprites etc). This is called 'sharing resources'. 
■Another idea is to dedicate a specific register to an 
apple atfon. Only that application can use that I/O 
register. Tin. means that you gel the real time, but you 
eannol use lhal reujstet anywhere else. This is called 
dedicating resources'. 
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FOOTBALL BOXFORM £14.95 cass £17.95 disk 

Not a gimmicky plaything but a genuine statistical analysis of 
football form the sole objective ol which is to improve the chances 
of winning on the pools or fixed odds. Written by a pools expert 
the program has forecast over 50% more draws than would 
be expected by chance. Homes, aways 8 draws are shown in 
order of merit and true odds given for every match. Merit tables 
show at a glance the teams currently in form and those having a 
lean spell. Separate AUSTRALIAN POOLS program included in the 
price. 

RACING BOXFORM & HANDICAP WINNER 
£14.95 cass £17.95 disk 

Two programmes for the price of one. Boxform weighs up a race by 
considering the many facets of form. Easily amended to suit the 
user's ideas. HANDICAP WINNER shows the value for money bets. 
Ouer 1000 winners every year and ON DERBY DAY 1990 THE 
PROGRAM GAVE THE WINNERS OF 7 OUT OF 9 HANDICAPS. 20/1 
10/1 7/1 11/2 4/1 4/1 6/4. PROBABLY THE BEST DAY'S RESULTS 
EVER ACHIEVED, WITH OR WITHOUT A COMPUTER. 

SPECIAL OFFER: All the aboue for £24.95 (disks E29.95) plus a 
FREE program to work out almost any bet. So good it's used by 



Why pay inflated prices? BOXofi CLEVER the same - get the BEST. 

Advertised for five years in the sporting and computer press. 
^^_ BOXOFT (CDU), 65 Allans Meadow, Neston, ^_ 

South Wirral, L64 9SQ W^% 

mmtm chequ e/P.O. /Access/Visa Tel: 051-336- r\ 1 



EDITORIAL ASSISTANT 

YC Magazine is looking for a young, enthusiastic 
games fanatic to become a YOP Editorial Assistant, 

The ideal applicant should have basic writing 
skills, would enjoy being wacky at shows, and 
must, above all else, enjoy playing computer 
games. 

If you feel you could better the country's top 
C64 title, apply in writing to Rik Hendei 



Editc 



The 



CLASSIFIED SALES EXECUTIVE 

An excellent opportunity has arisen for a classified 
sales executive with at least 6 months experience 
to handle classified sars =c:k= 3 Commodore 
titles and 2 health magazines. 

The position, based in Milton Keynes, offers an 
attractive lifestyle with competitive salary and 
commission package. 

Please apply in writing to The Advertisement 
Manager, 
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